Sign in

v51

latestOpenAPI 3.0.1MITraw.githubusercontent.com2026-08-01150230854.3 KB
Custom Object Instances

Create or Update a Custom Object Instance

Create or update a custom object instance

post/custom_object_instances/{custom_object_type_identifier}

Headers

Intercom-Version'1.0' | '1.1' | '1.2' | '1.3' | '1.4' | '2.0' | '2.1' | '2.2' | '2.3' | '2.4' | '2.5' | '2.6' | '2.7' | '2.8' | '2.9' | '2.10' | '2.11' | '2.12' | '2.13' | '2.14'

Intercom API version.</br>By default, it's equal to the version set in the app package.

Example:2.14

Request body

external_idstring

A unique identifier for the Custom Object instance in the external system it originated from.

external_created_atinteger nullable

The time when the Custom Object instance was created in the external system it originated from.

external_updated_atinteger nullable

The time when the Custom Object instance was last updated in the external system it originated from.

custom_attributesobject nullable

The custom attributes which are set for the Custom Object instance.

Example request

{
  "external_created_at": 1571672154,
  "external_updated_at": 1571672154
}

Response

successful

idstring

The Intercom defined id representing the custom object instance.

external_idstring

The id you have defined for the custom object instance.

external_created_atinteger nullable

The time when the Custom Object instance was created in the external system it originated from.

external_updated_atinteger nullable

The time when the Custom Object instance was last updated in the external system it originated from.

created_atinteger

The time the attribute was created as a UTC Unix timestamp

updated_atinteger

The time the attribute was last updated as a UTC Unix timestamp

typestring

The identifier of the custom object type that defines the structure of the custom object instance.

custom_attributesobject

The custom attributes you have set on the custom object instance.

Example response

{
  "external_id": "0001d1c1e65a7a19e9f59ae2",
  "external_created_at": 1571672154,
  "external_updated_at": 1571672154,
  "created_at": 1671028894,
  "updated_at": 1671028894,
  "type": "Order"
}