{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Create or update a custom object instance\n\nRequires the `read_write_custom_object_instances` OAuth scope.\n","properties":{"path":{"type":"object","properties":{"custom_object_type_identifier":{"type":"string","examples":["Order"],"description":"The unique identifier of the custom object type that defines the structure of the custom object instance."}},"required":["custom_object_type_identifier"],"additionalProperties":false},"headers":{"type":"object","properties":{"Intercom-Version":{"$ref":"#/definitions/intercom_version","enum":["2.17"]}},"required":[],"additionalProperties":false},"body":{"$ref":"#/definitions/create_or_update_custom_object_instance_request","examples":[{"external_id":"123","external_created_at":1392036272,"external_updated_at":1392036272,"custom_attributes":{"order_number":"ORDER-12345","total_amount":99.99}}]}},"required":["path"],"additionalProperties":false,"definitions":{"intercom_version":{"description":"Intercom API version.</br>If you omit the header, the API uses the version set in your app package, and 1.0 if none is set.","type":"string","enum":["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","2.15","2.16","2.17"],"examples":["2.17"]},"create_or_update_custom_object_instance_request":{"description":"Payload to create or update a Custom Object instance","type":"object","title":"Create Or Update Custom Object Instance Request Payload","properties":{"external_id":{"type":"string","description":"A unique identifier for the Custom Object instance in the external system it originated from. The value `reference_not_found` is reserved and is rejected with a `400`. Omitting this field creates a new instance on every request instead of updating an existing one."},"external_created_at":{"type":["integer","null"],"format":"date-time","description":"The time when the Custom Object instance was created in the external system it originated from. A value that cannot be read as a time is stored as `null` rather than rejected.","examples":[1571672154]},"external_updated_at":{"type":["integer","null"],"format":"date-time","description":"The time when the Custom Object instance was last updated in the external system it originated from. A value that cannot be read as a time is stored as `null` rather than rejected.","examples":[1571672154]},"custom_attributes":{"type":["object","null"],"description":"The custom attributes which are set for the Custom Object instance.\n\nEach value must match the type of the attribute it is set on: a string, integer, number or boolean, a Unix timestamp or date string for a datetime attribute, or `null` to clear the attribute. A list attribute takes the label or id of one of its options; a value that matches no option clears the attribute rather than being rejected. A reference attribute takes the Intercom id of the record it points at, or an array of ids for a reference to several records; an id that matches no record is skipped.","additionalProperties":{"anyOf":[{"type":["string","null"]},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"type":"string"}}]},"examples":[{"order_number":"ORDER-12345","total_amount":99.99}]}}}}},"name":"Create or Update a Custom Object Instance","id":"intercom.createcustomobjectinstances","example":{"path":{"custom_object_type_identifier":"Order"}},"maxRequests":1,"summary":false}}