Skip to main content
PUT
Create Custom Data Record
Before writing records, create a custom data table with the columns your application needs. Send values for declared table columns. Managed columns such as id, organization_id, created_at, and updated_at are controlled by Simple AI. For REFERENCE columns targeting contacts or calls, send the resource’s public UUID. A contact UUID is returned as contact.id by Upsert Synced Contact. Numeric IDs remain accepted for compatibility. Other custom-table references use numeric row IDs. Use the stored reference column name, which ends in _ref. For example:
Contact references must identify an active contact in your organization. Responses return contact and call references as UUIDs. The same UUID support applies to updates and reference filters.

Order source updates

For a table with a business key, add ?sourceUpdatedAtColumn=source_updated_at to compare the supplied timestamp with the stored value atomically. The named column must have type TIMESTAMP, and every request using this option must include a non-null timestamp and the business key. A new key is inserted. An existing key is updated only when its stored timestamp is null or the supplied timestamp is newer. Equal or older timestamps return 409 without changing the record. After a retry returns 409, read the record to check its current state. Omitting this option preserves normal upsert behavior. This option is available on individual PUT and PATCH requests.

Authorizations

Authorization
string
header
required

Path Parameters

table_name
string
required

Custom data table name.

Pattern: ^[A-Za-z0-9_-]+$

Query Parameters

sourceUpdatedAtColumn
string

Name of a TIMESTAMP column supplied with a non-null value. Atomically apply only if the stored timestamp is null or older. Equal/older values return 409. Ordered PUT also requires a configured business key and its value. Omit for normal write behavior.

Maximum string length: 63
Pattern: ^[a-z][a-z0-9_]*$

Body

application/json

Object containing values for declared table columns. Managed columns and unknown columns are ignored.

Response

Custom Data Record Created

record
Custom Data Record · object
required
Last modified on September 16, 2026