Get Custom Object Instance by ID

Request

Fetch a Custom Object Instance by id.

Security

bearerAuth

Path

custom_object_instance_idstringrequired

The id or external_id of the custom object instance

custom_object_type_identifierstringrequired

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

Example:Order

Intercom-Versionstring(intercom_version)

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

Default:"2.16"

Enum:"1.0""1.1""1.2""1.3""1.4""2.0""2.1""2.2""2.3""2.4"

Example:2.16

curl -i -X GET \
  'https://api.intercom.io/custom_object_instances/Order/{custom_object_instance_id}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Intercom-Version: 2.16'

Responses

successful

Bodyapplication/json

idstring

The Intercom defined id representing the custom object instance.

Example:16032025

external_idstring

The id you have defined for the custom object instance.

Example:"0001d1c1e65a7a19e9f59ae2"

external_created_atinteger or null, (date-time)

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

Example:1571672154

external_updated_atinteger or null, (date-time)

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

Example:1571672154

created_atinteger, (date-time)

The time the attribute was created as a UTC Unix timestamp

Example:1671028894

updated_atinteger, (date-time)

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

Example:1671028894

typestring

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

Example:"Order"

custom_attributesobject

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

Response

{
  "id": "25",
  "type": "Order",
  "custom_attributes": {
    "order_number": "ORDER-12345",
    "total_amount": 99.99
  },
  "external_id": "123",
  "external_created_at": null,
  "external_updated_at": null,
  "created_at": 1734537750,
  "updated_at": 1734537750
}