# Contact ## Definitions **get** `/v1/contacts/definitions` Returns the schema for all field and relationship definitions available on contacts, including both system-defined and custom fields. Useful for understanding the shape of contact data before creating or updating records. See [Fields and relationships](/using-the-api/fields-and-relationships/) for more details. **[Required scope](/using-the-api/scopes/):** `contacts:read` **[Rate limit category](/using-the-api/rate-limits/):** Read ### Returns - `ContactDefinitionsResponse = object { fieldDefinitions, objectType, relationshipDefinitions }` - `fieldDefinitions: map[object { description, label, typeConfiguration, 3 more } ]` Map of field keys to their definitions, including both system and custom fields. - `description: string` Description of the field, or null. - `label: string` Human-readable display name of the field. - `typeConfiguration: map[string or number or boolean or 2 more]` Type-specific configuration (e.g. select options, currency code). - `UnionMember0 = string` - `UnionMember1 = number` - `UnionMember2 = boolean` - `UnionMember3 = array of string or number or boolean or 2 more` - `UnionMember0 = string` - `UnionMember1 = number` - `UnionMember2 = boolean` - `UnionMember3 = array of unknown` - `UnionMember4 = map[unknown]` - `UnionMember4 = map[string or number or boolean or 2 more]` - `UnionMember0 = string` - `UnionMember1 = number` - `UnionMember2 = boolean` - `UnionMember3 = array of unknown` - `UnionMember4 = map[unknown]` - `valueType: "ADDRESS" or "CHECKBOX" or "CURRENCY" or 11 more` Data type of the field. - `"ADDRESS"` - `"CHECKBOX"` - `"CURRENCY"` - `"DATETIME"` - `"EMAIL"` - `"FULL_NAME"` - `"MARKDOWN"` - `"MULTI_SELECT"` - `"NUMBER"` - `"SINGLE_SELECT"` - `"SOCIAL_HANDLE"` - `"TELEPHONE"` - `"TEXT"` - `"URL"` - `id: optional string` Unique identifier of the field definition. - `readOnly: optional boolean` `true` for fields that are not writable via the API (e.g. AI-generated summaries). `false` or absent for writable fields. - `objectType: string` The object type these definitions belong to (e.g. `account`). - `relationshipDefinitions: map[object { cardinality, description, label, 2 more } ]` Map of relationship keys to their definitions. - `cardinality: "HAS_ONE" or "HAS_MANY"` Whether this is a `has_one` or `has_many` relationship. - `"HAS_ONE"` - `"HAS_MANY"` - `description: string` Description of the relationship, or null. - `label: string` Human-readable display name of the relationship. - `objectType: string` The type of the related object (e.g. `account`, `contact`). - `id: optional string` Unique identifier of the relationship definition. ### Example ```http curl https://api.lightfield.app/v1/contacts/definitions \ -H 'Lightfield-Version: 2026-03-01' \ -H "Authorization: Bearer $API_KEY" ``` ## Create **post** `/v1/contacts` Creates a new contact record. After creation, Lightfield automatically enriches the contact in the background. Supports idempotency via the `Idempotency-Key` header. **[Required scope](/using-the-api/scopes/):** `contacts:create` **[Rate limit category](/using-the-api/rate-limits/):** Write ### Body Parameters - `fields: object { "$email", "$name", "$profilePhotoUrl" } or map[string or number or boolean or 2 more]` Field values for the new contact. System fields use a `$` prefix (e.g. `$email`, `$name`); custom attributes use their bare slug. Note: `$name` is an object `{ firstName, lastName }`, not a plain string. Call the [definitions endpoint](/api/resources/contact/methods/definitions) to discover available fields and their types. See [Fields and relationships](/using-the-api/fields-and-relationships/) for value type details. - `UnionMember0 = object { "$email", "$name", "$profilePhotoUrl" }` - `"$email": optional array of string` List of email addresses for the contact (`EMAIL`, multi-value). - `"$name": optional object { firstName, lastName }` The contact's name. Unlike other resources, this is an object: `{ firstName?: string, lastName?: string }`, not a plain string. - `firstName: optional string` The contact's first name. - `lastName: optional string` The contact's last name. - `"$profilePhotoUrl": optional string` URL of the contact's profile photo (`URL`). - `UnionMember1 = map[string or number or boolean or 2 more]` - `UnionMember0 = string` - `UnionMember1 = number` - `UnionMember2 = boolean` - `UnionMember3 = array of string or number or boolean or 2 more` - `UnionMember0 = string` - `UnionMember1 = number` - `UnionMember2 = boolean` - `UnionMember3 = array of unknown` - `UnionMember4 = map[unknown]` - `UnionMember4 = map[string or number or boolean or 2 more]` - `UnionMember0 = string` - `UnionMember1 = number` - `UnionMember2 = boolean` - `UnionMember3 = array of unknown` - `UnionMember4 = map[unknown]` - `relationships: optional object { "$account" } or map[string or array of string]` Relationships to set on the new contact. System relationships use a `$` prefix (e.g. `$account`); custom relationships use their bare slug. Each value is a single entity ID or an array of IDs. Call the [definitions endpoint](/api/resources/contact/methods/definitions) to list available relationship keys. - `Account = object { "$account" }` - `"$account": optional string or array of string` ID(s) of accounts to associate with this contact. - `UnionMember0 = string` - `UnionMember1 = array of string` - `UnionMember1 = map[string or array of string]` - `UnionMember0 = string` - `UnionMember1 = array of string` ### Returns - `ContactCreateResponse = object { id, createdAt, fields, 2 more }` - `id: string` Unique identifier for the entity. - `createdAt: string` ISO 8601 timestamp of when the entity was created. - `fields: map[object { value, valueType } ]` Map of field names to their typed values. System fields are prefixed with `$` (e.g. `$name`, `$email`); custom attributes use their bare slug. - `value: string or number or boolean or 2 more` The field value, or null if unset. - `UnionMember0 = string` - `UnionMember1 = number` - `UnionMember2 = boolean` - `UnionMember3 = array of string or number or boolean or 2 more` - `UnionMember0 = string` - `UnionMember1 = number` - `UnionMember2 = boolean` - `UnionMember3 = array of unknown` - `UnionMember4 = map[unknown]` - `UnionMember4 = map[string or number or boolean or 2 more]` - `UnionMember0 = string` - `UnionMember1 = number` - `UnionMember2 = boolean` - `UnionMember3 = array of unknown` - `UnionMember4 = map[unknown]` - `valueType: "ADDRESS" or "CHECKBOX" or "CURRENCY" or 11 more` The data type of the field. - `"ADDRESS"` - `"CHECKBOX"` - `"CURRENCY"` - `"DATETIME"` - `"EMAIL"` - `"FULL_NAME"` - `"MARKDOWN"` - `"MULTI_SELECT"` - `"NUMBER"` - `"SINGLE_SELECT"` - `"SOCIAL_HANDLE"` - `"TELEPHONE"` - `"TEXT"` - `"URL"` - `httpLink: string` URL to view the entity in the Lightfield web app, or null. - `relationships: map[object { cardinality, objectType, values } ]` Map of relationship names to their associated entities. System relationships are prefixed with `$` (e.g. `$owner`, `$contact`). - `cardinality: string` Whether the relationship is `has_one` or `has_many`. - `objectType: string` The type of the related object (e.g. `account`, `contact`). - `values: array of string` IDs of the related entities. ### Example ```http curl https://api.lightfield.app/v1/contacts \ -H 'Content-Type: application/json' \ -H 'Lightfield-Version: 2026-03-01' \ -H "Authorization: Bearer $API_KEY" \ -d '{ "fields": {} }' ``` ## Update **post** `/v1/contacts/{id}` Updates an existing contact by ID. Only included fields and relationships are modified. Supports idempotency via the `Idempotency-Key` header. **[Required scope](/using-the-api/scopes/):** `contacts:update` **[Rate limit category](/using-the-api/rate-limits/):** Write ### Path Parameters - `id: string` Unique identifier of the contact to update. ### Body Parameters - `fields: optional object { "$email", "$name", "$profilePhotoUrl" } or map[string or number or boolean or 2 more]` Field values to update — only provided fields are modified; omitted fields are left unchanged. System fields use a `$` prefix (e.g. `$email`); custom attributes use their bare slug. Note: `$name` is an object `{ firstName, lastName }`, not a plain string. Call the [definitions endpoint](/api/resources/contact/methods/definitions) for available fields and types. See [Fields and relationships](/using-the-api/fields-and-relationships/) for value type details. - `UnionMember0 = object { "$email", "$name", "$profilePhotoUrl" }` - `"$email": optional array of string` List of email addresses for the contact (`EMAIL`, multi-value). - `"$name": optional object { firstName, lastName }` The contact's name. Unlike other resources, this is an object: `{ firstName?: string, lastName?: string }`, not a plain string. - `firstName: optional string` The contact's first name. - `lastName: optional string` The contact's last name. - `"$profilePhotoUrl": optional string` URL of the contact's profile photo (`URL`). - `UnionMember1 = map[string or number or boolean or 2 more]` - `UnionMember0 = string` - `UnionMember1 = number` - `UnionMember2 = boolean` - `UnionMember3 = array of string or number or boolean or 2 more` - `UnionMember0 = string` - `UnionMember1 = number` - `UnionMember2 = boolean` - `UnionMember3 = array of unknown` - `UnionMember4 = map[unknown]` - `UnionMember4 = map[string or number or boolean or 2 more]` - `UnionMember0 = string` - `UnionMember1 = number` - `UnionMember2 = boolean` - `UnionMember3 = array of unknown` - `UnionMember4 = map[unknown]` - `relationships: optional object { "$account" } or map[object { add, remove, replace } ]` Relationship operations to apply. System relationships use a `$` prefix (e.g. `$account`). Each value is an operation object with `add`, `remove`, or `replace`. - `Account = object { "$account" }` - `"$account": optional object { add, remove, replace }` Operation to modify associated accounts. - `add: optional string or array of string` Entity ID(s) to add to the relationship. - `UnionMember0 = string` - `UnionMember1 = array of string` - `remove: optional string or array of string` Entity ID(s) to remove from the relationship. - `UnionMember0 = string` - `UnionMember1 = array of string` - `replace: optional string or array of string` Entity ID(s) to set as the entire relationship, replacing all existing associations. - `UnionMember0 = string` - `UnionMember1 = array of string` - `UnionMember1 = map[object { add, remove, replace } ]` - `add: optional string or array of string` Entity ID(s) to add to the relationship. - `UnionMember0 = string` - `UnionMember1 = array of string` - `remove: optional string or array of string` Entity ID(s) to remove from the relationship. - `UnionMember0 = string` - `UnionMember1 = array of string` - `replace: optional string or array of string` Entity ID(s) to set as the entire relationship, replacing all existing associations. - `UnionMember0 = string` - `UnionMember1 = array of string` ### Returns - `ContactUpdateResponse = object { id, createdAt, fields, 2 more }` - `id: string` Unique identifier for the entity. - `createdAt: string` ISO 8601 timestamp of when the entity was created. - `fields: map[object { value, valueType } ]` Map of field names to their typed values. System fields are prefixed with `$` (e.g. `$name`, `$email`); custom attributes use their bare slug. - `value: string or number or boolean or 2 more` The field value, or null if unset. - `UnionMember0 = string` - `UnionMember1 = number` - `UnionMember2 = boolean` - `UnionMember3 = array of string or number or boolean or 2 more` - `UnionMember0 = string` - `UnionMember1 = number` - `UnionMember2 = boolean` - `UnionMember3 = array of unknown` - `UnionMember4 = map[unknown]` - `UnionMember4 = map[string or number or boolean or 2 more]` - `UnionMember0 = string` - `UnionMember1 = number` - `UnionMember2 = boolean` - `UnionMember3 = array of unknown` - `UnionMember4 = map[unknown]` - `valueType: "ADDRESS" or "CHECKBOX" or "CURRENCY" or 11 more` The data type of the field. - `"ADDRESS"` - `"CHECKBOX"` - `"CURRENCY"` - `"DATETIME"` - `"EMAIL"` - `"FULL_NAME"` - `"MARKDOWN"` - `"MULTI_SELECT"` - `"NUMBER"` - `"SINGLE_SELECT"` - `"SOCIAL_HANDLE"` - `"TELEPHONE"` - `"TEXT"` - `"URL"` - `httpLink: string` URL to view the entity in the Lightfield web app, or null. - `relationships: map[object { cardinality, objectType, values } ]` Map of relationship names to their associated entities. System relationships are prefixed with `$` (e.g. `$owner`, `$contact`). - `cardinality: string` Whether the relationship is `has_one` or `has_many`. - `objectType: string` The type of the related object (e.g. `account`, `contact`). - `values: array of string` IDs of the related entities. ### Example ```http curl https://api.lightfield.app/v1/contacts/$ID \ -H 'Content-Type: application/json' \ -H 'Lightfield-Version: 2026-03-01' \ -H "Authorization: Bearer $API_KEY" \ -d '{}' ``` ## Retrieve **get** `/v1/contacts/{id}` Retrieves a single contact by its ID. **[Required scope](/using-the-api/scopes/):** `contacts:read` **[Rate limit category](/using-the-api/rate-limits/):** Read ### Path Parameters - `id: string` Unique identifier of the contact to retrieve. ### Returns - `ContactRetrieveResponse = object { id, createdAt, fields, 2 more }` - `id: string` Unique identifier for the entity. - `createdAt: string` ISO 8601 timestamp of when the entity was created. - `fields: map[object { value, valueType } ]` Map of field names to their typed values. System fields are prefixed with `$` (e.g. `$name`, `$email`); custom attributes use their bare slug. - `value: string or number or boolean or 2 more` The field value, or null if unset. - `UnionMember0 = string` - `UnionMember1 = number` - `UnionMember2 = boolean` - `UnionMember3 = array of string or number or boolean or 2 more` - `UnionMember0 = string` - `UnionMember1 = number` - `UnionMember2 = boolean` - `UnionMember3 = array of unknown` - `UnionMember4 = map[unknown]` - `UnionMember4 = map[string or number or boolean or 2 more]` - `UnionMember0 = string` - `UnionMember1 = number` - `UnionMember2 = boolean` - `UnionMember3 = array of unknown` - `UnionMember4 = map[unknown]` - `valueType: "ADDRESS" or "CHECKBOX" or "CURRENCY" or 11 more` The data type of the field. - `"ADDRESS"` - `"CHECKBOX"` - `"CURRENCY"` - `"DATETIME"` - `"EMAIL"` - `"FULL_NAME"` - `"MARKDOWN"` - `"MULTI_SELECT"` - `"NUMBER"` - `"SINGLE_SELECT"` - `"SOCIAL_HANDLE"` - `"TELEPHONE"` - `"TEXT"` - `"URL"` - `httpLink: string` URL to view the entity in the Lightfield web app, or null. - `relationships: map[object { cardinality, objectType, values } ]` Map of relationship names to their associated entities. System relationships are prefixed with `$` (e.g. `$owner`, `$contact`). - `cardinality: string` Whether the relationship is `has_one` or `has_many`. - `objectType: string` The type of the related object (e.g. `account`, `contact`). - `values: array of string` IDs of the related entities. ### Example ```http curl https://api.lightfield.app/v1/contacts/$ID \ -H 'Lightfield-Version: 2026-03-01' \ -H "Authorization: Bearer $API_KEY" ``` ## List **get** `/v1/contacts` Returns a paginated list of contacts. Use `offset` and `limit` to paginate through results. See [List endpoints](/using-the-api/list-endpoints/) for more information about pagination. **[Required scope](/using-the-api/scopes/):** `contacts:read` **[Rate limit category](/using-the-api/rate-limits/):** Search ### Query Parameters - `limit: optional number` Maximum number of records to return. Defaults to 25, maximum 25. - `offset: optional number` Number of records to skip for pagination. Defaults to 0. ### Returns - `ContactListResponse = object { data, object, totalCount }` - `data: array of object { id, createdAt, fields, 2 more }` Array of entity objects for the current page. - `id: string` Unique identifier for the entity. - `createdAt: string` ISO 8601 timestamp of when the entity was created. - `fields: map[object { value, valueType } ]` Map of field names to their typed values. System fields are prefixed with `$` (e.g. `$name`, `$email`); custom attributes use their bare slug. - `value: string or number or boolean or 2 more` The field value, or null if unset. - `UnionMember0 = string` - `UnionMember1 = number` - `UnionMember2 = boolean` - `UnionMember3 = array of string or number or boolean or 2 more` - `UnionMember0 = string` - `UnionMember1 = number` - `UnionMember2 = boolean` - `UnionMember3 = array of unknown` - `UnionMember4 = map[unknown]` - `UnionMember4 = map[string or number or boolean or 2 more]` - `UnionMember0 = string` - `UnionMember1 = number` - `UnionMember2 = boolean` - `UnionMember3 = array of unknown` - `UnionMember4 = map[unknown]` - `valueType: "ADDRESS" or "CHECKBOX" or "CURRENCY" or 11 more` The data type of the field. - `"ADDRESS"` - `"CHECKBOX"` - `"CURRENCY"` - `"DATETIME"` - `"EMAIL"` - `"FULL_NAME"` - `"MARKDOWN"` - `"MULTI_SELECT"` - `"NUMBER"` - `"SINGLE_SELECT"` - `"SOCIAL_HANDLE"` - `"TELEPHONE"` - `"TEXT"` - `"URL"` - `httpLink: string` URL to view the entity in the Lightfield web app, or null. - `relationships: map[object { cardinality, objectType, values } ]` Map of relationship names to their associated entities. System relationships are prefixed with `$` (e.g. `$owner`, `$contact`). - `cardinality: string` Whether the relationship is `has_one` or `has_many`. - `objectType: string` The type of the related object (e.g. `account`, `contact`). - `values: array of string` IDs of the related entities. - `object: string` The object type, always `"list"`. - `totalCount: number` Total number of entities matching the query. ### Example ```http curl https://api.lightfield.app/v1/contacts \ -H 'Lightfield-Version: 2026-03-01' \ -H "Authorization: Bearer $API_KEY" ``` ## Domain Types ### Contact Create Response - `ContactCreateResponse = object { id, createdAt, fields, 2 more }` - `id: string` Unique identifier for the entity. - `createdAt: string` ISO 8601 timestamp of when the entity was created. - `fields: map[object { value, valueType } ]` Map of field names to their typed values. System fields are prefixed with `$` (e.g. `$name`, `$email`); custom attributes use their bare slug. - `value: string or number or boolean or 2 more` The field value, or null if unset. - `UnionMember0 = string` - `UnionMember1 = number` - `UnionMember2 = boolean` - `UnionMember3 = array of string or number or boolean or 2 more` - `UnionMember0 = string` - `UnionMember1 = number` - `UnionMember2 = boolean` - `UnionMember3 = array of unknown` - `UnionMember4 = map[unknown]` - `UnionMember4 = map[string or number or boolean or 2 more]` - `UnionMember0 = string` - `UnionMember1 = number` - `UnionMember2 = boolean` - `UnionMember3 = array of unknown` - `UnionMember4 = map[unknown]` - `valueType: "ADDRESS" or "CHECKBOX" or "CURRENCY" or 11 more` The data type of the field. - `"ADDRESS"` - `"CHECKBOX"` - `"CURRENCY"` - `"DATETIME"` - `"EMAIL"` - `"FULL_NAME"` - `"MARKDOWN"` - `"MULTI_SELECT"` - `"NUMBER"` - `"SINGLE_SELECT"` - `"SOCIAL_HANDLE"` - `"TELEPHONE"` - `"TEXT"` - `"URL"` - `httpLink: string` URL to view the entity in the Lightfield web app, or null. - `relationships: map[object { cardinality, objectType, values } ]` Map of relationship names to their associated entities. System relationships are prefixed with `$` (e.g. `$owner`, `$contact`). - `cardinality: string` Whether the relationship is `has_one` or `has_many`. - `objectType: string` The type of the related object (e.g. `account`, `contact`). - `values: array of string` IDs of the related entities. ### Contact Definitions Response - `ContactDefinitionsResponse = object { fieldDefinitions, objectType, relationshipDefinitions }` - `fieldDefinitions: map[object { description, label, typeConfiguration, 3 more } ]` Map of field keys to their definitions, including both system and custom fields. - `description: string` Description of the field, or null. - `label: string` Human-readable display name of the field. - `typeConfiguration: map[string or number or boolean or 2 more]` Type-specific configuration (e.g. select options, currency code). - `UnionMember0 = string` - `UnionMember1 = number` - `UnionMember2 = boolean` - `UnionMember3 = array of string or number or boolean or 2 more` - `UnionMember0 = string` - `UnionMember1 = number` - `UnionMember2 = boolean` - `UnionMember3 = array of unknown` - `UnionMember4 = map[unknown]` - `UnionMember4 = map[string or number or boolean or 2 more]` - `UnionMember0 = string` - `UnionMember1 = number` - `UnionMember2 = boolean` - `UnionMember3 = array of unknown` - `UnionMember4 = map[unknown]` - `valueType: "ADDRESS" or "CHECKBOX" or "CURRENCY" or 11 more` Data type of the field. - `"ADDRESS"` - `"CHECKBOX"` - `"CURRENCY"` - `"DATETIME"` - `"EMAIL"` - `"FULL_NAME"` - `"MARKDOWN"` - `"MULTI_SELECT"` - `"NUMBER"` - `"SINGLE_SELECT"` - `"SOCIAL_HANDLE"` - `"TELEPHONE"` - `"TEXT"` - `"URL"` - `id: optional string` Unique identifier of the field definition. - `readOnly: optional boolean` `true` for fields that are not writable via the API (e.g. AI-generated summaries). `false` or absent for writable fields. - `objectType: string` The object type these definitions belong to (e.g. `account`). - `relationshipDefinitions: map[object { cardinality, description, label, 2 more } ]` Map of relationship keys to their definitions. - `cardinality: "HAS_ONE" or "HAS_MANY"` Whether this is a `has_one` or `has_many` relationship. - `"HAS_ONE"` - `"HAS_MANY"` - `description: string` Description of the relationship, or null. - `label: string` Human-readable display name of the relationship. - `objectType: string` The type of the related object (e.g. `account`, `contact`). - `id: optional string` Unique identifier of the relationship definition. ### Contact List Response - `ContactListResponse = object { data, object, totalCount }` - `data: array of object { id, createdAt, fields, 2 more }` Array of entity objects for the current page. - `id: string` Unique identifier for the entity. - `createdAt: string` ISO 8601 timestamp of when the entity was created. - `fields: map[object { value, valueType } ]` Map of field names to their typed values. System fields are prefixed with `$` (e.g. `$name`, `$email`); custom attributes use their bare slug. - `value: string or number or boolean or 2 more` The field value, or null if unset. - `UnionMember0 = string` - `UnionMember1 = number` - `UnionMember2 = boolean` - `UnionMember3 = array of string or number or boolean or 2 more` - `UnionMember0 = string` - `UnionMember1 = number` - `UnionMember2 = boolean` - `UnionMember3 = array of unknown` - `UnionMember4 = map[unknown]` - `UnionMember4 = map[string or number or boolean or 2 more]` - `UnionMember0 = string` - `UnionMember1 = number` - `UnionMember2 = boolean` - `UnionMember3 = array of unknown` - `UnionMember4 = map[unknown]` - `valueType: "ADDRESS" or "CHECKBOX" or "CURRENCY" or 11 more` The data type of the field. - `"ADDRESS"` - `"CHECKBOX"` - `"CURRENCY"` - `"DATETIME"` - `"EMAIL"` - `"FULL_NAME"` - `"MARKDOWN"` - `"MULTI_SELECT"` - `"NUMBER"` - `"SINGLE_SELECT"` - `"SOCIAL_HANDLE"` - `"TELEPHONE"` - `"TEXT"` - `"URL"` - `httpLink: string` URL to view the entity in the Lightfield web app, or null. - `relationships: map[object { cardinality, objectType, values } ]` Map of relationship names to their associated entities. System relationships are prefixed with `$` (e.g. `$owner`, `$contact`). - `cardinality: string` Whether the relationship is `has_one` or `has_many`. - `objectType: string` The type of the related object (e.g. `account`, `contact`). - `values: array of string` IDs of the related entities. - `object: string` The object type, always `"list"`. - `totalCount: number` Total number of entities matching the query. ### Contact Retrieve Response - `ContactRetrieveResponse = object { id, createdAt, fields, 2 more }` - `id: string` Unique identifier for the entity. - `createdAt: string` ISO 8601 timestamp of when the entity was created. - `fields: map[object { value, valueType } ]` Map of field names to their typed values. System fields are prefixed with `$` (e.g. `$name`, `$email`); custom attributes use their bare slug. - `value: string or number or boolean or 2 more` The field value, or null if unset. - `UnionMember0 = string` - `UnionMember1 = number` - `UnionMember2 = boolean` - `UnionMember3 = array of string or number or boolean or 2 more` - `UnionMember0 = string` - `UnionMember1 = number` - `UnionMember2 = boolean` - `UnionMember3 = array of unknown` - `UnionMember4 = map[unknown]` - `UnionMember4 = map[string or number or boolean or 2 more]` - `UnionMember0 = string` - `UnionMember1 = number` - `UnionMember2 = boolean` - `UnionMember3 = array of unknown` - `UnionMember4 = map[unknown]` - `valueType: "ADDRESS" or "CHECKBOX" or "CURRENCY" or 11 more` The data type of the field. - `"ADDRESS"` - `"CHECKBOX"` - `"CURRENCY"` - `"DATETIME"` - `"EMAIL"` - `"FULL_NAME"` - `"MARKDOWN"` - `"MULTI_SELECT"` - `"NUMBER"` - `"SINGLE_SELECT"` - `"SOCIAL_HANDLE"` - `"TELEPHONE"` - `"TEXT"` - `"URL"` - `httpLink: string` URL to view the entity in the Lightfield web app, or null. - `relationships: map[object { cardinality, objectType, values } ]` Map of relationship names to their associated entities. System relationships are prefixed with `$` (e.g. `$owner`, `$contact`). - `cardinality: string` Whether the relationship is `has_one` or `has_many`. - `objectType: string` The type of the related object (e.g. `account`, `contact`). - `values: array of string` IDs of the related entities. ### Contact Update Response - `ContactUpdateResponse = object { id, createdAt, fields, 2 more }` - `id: string` Unique identifier for the entity. - `createdAt: string` ISO 8601 timestamp of when the entity was created. - `fields: map[object { value, valueType } ]` Map of field names to their typed values. System fields are prefixed with `$` (e.g. `$name`, `$email`); custom attributes use their bare slug. - `value: string or number or boolean or 2 more` The field value, or null if unset. - `UnionMember0 = string` - `UnionMember1 = number` - `UnionMember2 = boolean` - `UnionMember3 = array of string or number or boolean or 2 more` - `UnionMember0 = string` - `UnionMember1 = number` - `UnionMember2 = boolean` - `UnionMember3 = array of unknown` - `UnionMember4 = map[unknown]` - `UnionMember4 = map[string or number or boolean or 2 more]` - `UnionMember0 = string` - `UnionMember1 = number` - `UnionMember2 = boolean` - `UnionMember3 = array of unknown` - `UnionMember4 = map[unknown]` - `valueType: "ADDRESS" or "CHECKBOX" or "CURRENCY" or 11 more` The data type of the field. - `"ADDRESS"` - `"CHECKBOX"` - `"CURRENCY"` - `"DATETIME"` - `"EMAIL"` - `"FULL_NAME"` - `"MARKDOWN"` - `"MULTI_SELECT"` - `"NUMBER"` - `"SINGLE_SELECT"` - `"SOCIAL_HANDLE"` - `"TELEPHONE"` - `"TEXT"` - `"URL"` - `httpLink: string` URL to view the entity in the Lightfield web app, or null. - `relationships: map[object { cardinality, objectType, values } ]` Map of relationship names to their associated entities. System relationships are prefixed with `$` (e.g. `$owner`, `$contact`). - `cardinality: string` Whether the relationship is `has_one` or `has_many`. - `objectType: string` The type of the related object (e.g. `account`, `contact`). - `values: array of string` IDs of the related entities.