v1

latestOpenAPI 3.1.02026-07-2670105729.6 KB
Contact Fields

Create a contact field

Creates a custom field definition ({ fieldName, fieldType: "string" | "number" | "date" | "bool" }). Returns 201 with the bare definition. (Contact upserts also auto-create unknown fields — explicit creation is for pinning the type up front.)

post/v1/fields

Headers

Idempotency-Keystring

Optional idempotency key for safe retries. Reusing the same key with the same request body returns the original response for 24 hours.

Request body

fieldNamestring required
fieldType'string' | 'number' | 'date' | 'bool' required

Response

Created.

fieldNamestring required
fieldType'string' | 'number' | 'date' | 'bool' required
labelstring
isCoreboolean
isFilterableboolean
isSortableboolean
isSearchableboolean