Create record

cURL

curl --request POST \
  --url https://api.unifygtm.com/data/v1/objects/{object_name}/records \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "data": {}
}'

import requests

url = "https://api.unifygtm.com/data/v1/objects/{object_name}/records"

payload = { "data": {} }
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({data: {}})
};

fetch('https://api.unifygtm.com/data/v1/objects/{object_name}/records', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.unifygtm.com/data/v1/objects/{object_name}/records",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'data' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.unifygtm.com/data/v1/objects/{object_name}/records"

	payload := strings.NewReader("{\n  \"data\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.unifygtm.com/data/v1/objects/{object_name}/records")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"data\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.unifygtm.com/data/v1/objects/{object_name}/records")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"data\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "data": {
    "object": "<string>",
    "id": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "attributes": {}
  }
}

{
  "status": "bad_request",
  "errors": [
    {
      "code": "<string>",
      "path": [
        "<string>"
      ],
      "object_api_name": "<string>",
      "attribute_api_name": "<string>"
    }
  ],
  "message": "<string>"
}

{
  "status": "unauthorized",
  "message": "<string>"
}

{
  "status": "object_not_found",
  "message": "<string>"
}

{
  "status": "record_conflict",
  "message": "<string>"
}

{
  "status": "error",
  "message": "<string>"
}

{
  "status": "service_unavailable",
  "message": "<string>"
}

POST

data

objects

{object_name}

records

cURL

curl --request POST \
  --url https://api.unifygtm.com/data/v1/objects/{object_name}/records \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "data": {}
}'

import requests

url = "https://api.unifygtm.com/data/v1/objects/{object_name}/records"

payload = { "data": {} }
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({data: {}})
};

fetch('https://api.unifygtm.com/data/v1/objects/{object_name}/records', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.unifygtm.com/data/v1/objects/{object_name}/records",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'data' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.unifygtm.com/data/v1/objects/{object_name}/records"

	payload := strings.NewReader("{\n  \"data\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.unifygtm.com/data/v1/objects/{object_name}/records")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"data\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.unifygtm.com/data/v1/objects/{object_name}/records")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"data\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "data": {
    "object": "<string>",
    "id": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "attributes": {}
  }
}

{
  "status": "bad_request",
  "errors": [
    {
      "code": "<string>",
      "path": [
        "<string>"
      ],
      "object_api_name": "<string>",
      "attribute_api_name": "<string>"
    }
  ],
  "message": "<string>"
}

{
  "status": "unauthorized",
  "message": "<string>"
}

{
  "status": "object_not_found",
  "message": "<string>"
}

{
  "status": "record_conflict",
  "message": "<string>"
}

{
  "status": "error",
  "message": "<string>"
}

{
  "status": "service_unavailable",
  "message": "<string>"
}

Overview

The create method creates a new record in the specified object. This method will fail if any record already exists with conflicting unique values, which may or may not be the desired behavior depending on your use case. If you are not sure whether a record already exists with the same unique values, consider using the upsert method instead.

Examples

Create a company

This creates a new company record:

POST /objects/company/records

{
  "name": "Unify",
  "domain": "unifygtm.com",
  "description": "A nice company with a top-notch API.",
  "status": "Active"
}

{
  "status": "success",
  "data": {
    "object": "company",
    "id": "73fcb798-9ccd-4138-8f6a-9a801123783c",
    "created_at": "2025-09-04T01:23:45Z",
    "updated_at": "2025-09-04T01:23:45Z",
    "attributes": {
      "name": "Unify",
      "domain": "unifygtm.com",
      "description": "A nice company with a top-notch API.",
      "status": "Active"
      // ...
    }
  }
}

Create a person

This creates a new person record and links them to an existing company if it exists:

POST /objects/person/records

{
  "first_name": "Austin",
  "last_name": "Hughes",
  "email": "austinhughes@unifygtm.com",
  "title": "CEO",
  "company": {
    "match": {
      "domain": "unifygtm.com"
    }
  }
}

{
  "status": "success",
  "data": {
    "object": "person",
    "id": "bf3f4d5e-c995-496f-8774-5a1c58d05197",
    "created_at": "2025-09-04T01:23:45Z",
    "updated_at": "2025-09-04T01:23:45Z",
    "attributes": {
      "first_name": "Austin",
      "last_name": "Hughes",
      "email": "austinhughes@unifygtm.com",
      "title": "CEO",
      "company": "73fcb798-9ccd-4138-8f6a-9a801123783c"
      // ...
    }
  }
}

If a company with this domain does not exist, the company reference on this person will be null. If you want to create a company in that case instead, you can use a nested upsert:

POST /objects/person/records

{
  "first_name": "Austin",
  "last_name": "Hughes",
  "email": "austinhughes@unifygtm.com",
  "title": "CEO",
  "company": {
    "match": {
      "domain": "unifygtm.com"
    },
    "create": {
      "name": "Unify",
      "domain": "unifygtm.com",
      "linkedin_url": "https://www.linkedin.com/company/unifygtm"
    }
  }
}

{
  "status": "success",
  "data": {
    "object": "person",
    "id": "bf3f4d5e-c995-496f-8774-5a1c58d05197",
    "created_at": "2025-09-04T01:23:45Z",
    "updated_at": "2025-09-04T01:23:45Z",
    "attributes": {
      "first_name": "Austin",
      "last_name": "Hughes",
      "email": "austinhughes@unifygtm.com",
      "title": "CEO",
      "company": "73fcb798-9ccd-4138-8f6a-9a801123783c"
      // ...
    }
  }
}

Create a custom record

This creates a new record in a custom object called product_user:

POST /objects/product_user/records

{
  "user_id": "6b2a2761-3cbe-481f-8a1e-b24859c674f8",
  "full_name": "Bob Smith",
  "email_address": "bob.smith@gmail.com",
  "plan": "free_tier"
}

{
  "status": "success",
  "data": {
    "object": "product_user",
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "created_at": "2025-09-04T01:23:45Z",
    "updated_at": "2025-09-04T01:23:45Z",
    "attributes": {
      "user_id": "6b2a2761-3cbe-481f-8a1e-b24859c674f8",
      "full_name": "Bob Smith",
      "email_address": "bob.smith@gmail.com",
      "plan": "free_tier"
      // ...
    }
  }
}

Usage

Authorizations

x-api-key

string

header

required

Path Parameters

object_name

string

required

The API name of an object, e.g. company, person, opportunity, or a custom object's API name.

Query Parameters

validation_mode

enum<string>

Validation mode for request data.

strict: Reject requests if any attribute is invalid or unrecognized.
ignore_invalid: Ignore unknown attributes and omit invalid values for optional attributes. Reject requests with an invalid body structure or invalid required attributes.

Available options:

strict,

ignore_invalid

Body

application/json

Request body for creating a record.

data

object

required

The attribute values for the new record.

All required attributes on the object must be included.

Response

Response for a successful create operation.

status

enum<string>

required

Available options:

success

data

object

required

Show child attributes

⌘I

Unify Platform

MCP

Developer Guides

API Reference

SDKs

Create record

Overview

Examples

Usage

Authorizations

Path Parameters

Query Parameters

Body

Response

​Overview

​Examples

​Usage

Authorizations

Path Parameters

Query Parameters

Body

Response

Overview

Examples

Usage