# Merge ## Merge two accounts `client.merge.mergeAccounts(MergeMergeAccountsParamsbody, RequestOptionsoptions?): MergeMergeAccountsResponse` **post** `/v1/accounts/merge` Merges two accounts into one. The primary account retains its ID; the duplicate is soft-deleted. **[Required scopes](/using-the-api/scopes/):** `accounts:update` + `accounts:delete` **[Rate limit category](/using-the-api/rate-limits/):** Write ### Parameters - `body: MergeMergeAccountsParams` - `duplicateId: string` ID of the duplicate record to merge into the primary and then discard. - `primaryId: string` ID of the record to keep. - `fieldResolutions?: Record` Per-field resolution overrides keyed by attribute slug. - `"primary" | "duplicate"` - `"primary"` - `"duplicate"` - `Value` - `value: string | number | boolean | 3 more | null` - `string` - `number` - `boolean` - `Array` - `Address` - `city?: string | null` City name. - `country?: string | null` 2-letter ISO 3166-1 alpha-2 country code. - `latitude?: number | null` Latitude coordinate. - `longitude?: number | null` Longitude coordinate. - `postalCode?: string | null` Postal or ZIP code. - `state?: string | null` State or province. - `street?: string | null` Street address line 1. - `street2?: string | null` Street address line 2. - `FullName` - `firstName?: string | null` The contact's first name. - `lastName?: string | null` The contact's last name. - `options?: Options` - `multiSelectUnion?: boolean` When true, multi-select fields are merged by union rather than primary-takes-all. ### Returns - `MergeMergeAccountsResponse` - `merge: Merge` - `id: string` Unique identifier for the merge operation. - `status: string` Current status of the merge: `cleanup_pending`, `done`, or `failed`. - `primary: Primary` - `id: string` Unique identifier for the entity. - `createdAt: string` ISO 8601 timestamp of when the entity was created. - `fields: Record` 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 | number | boolean | 3 more | null` The field value, or null if unset. - `string` - `number` - `boolean` - `Array` - `Address` - `city?: string | null` City name. - `country?: string | null` 2-letter ISO 3166-1 alpha-2 country code. - `latitude?: number | null` Latitude coordinate. - `longitude?: number | null` Longitude coordinate. - `postalCode?: string | null` Postal or ZIP code. - `state?: string | null` State or province. - `street?: string | null` Street address line 1. - `street2?: string | null` Street address line 2. - `FullName` - `firstName?: string | null` The contact's first name. - `lastName?: string | null` The contact's last name. - `valueType: "ADDRESS" | "CHECKBOX" | "CURRENCY" | 12 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"` - `"HTML"` - `httpLink: string | null` URL to view the entity in the Lightfield web app, or null. - `relationships: Record` 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` IDs of the related entities. - `updatedAt: string | null` ISO 8601 timestamp of when the entity was last updated, or null. - `externalId?: string | null` External identifier for the entity, or null if unset. - `summary: Summary` - `fieldWriteCount: number` Number of attribute fields written onto the primary record. - `syncRepointedCount: number` Number of related records re-pointed from the duplicate to the primary. - `warnings: Array` Non-fatal warnings from the merge (e.g. skipped transfers). ### Example ```typescript import Lightfield from 'lightfield'; const client = new Lightfield({ apiKey: 'My API Key', }); const mergeMergeAccountsResponse = await client.merge.mergeAccounts({ duplicateId: 'duplicateId', primaryId: 'primaryId', }); console.log(mergeMergeAccountsResponse.merge); ``` #### Response ```json { "merge": { "id": "id", "status": "status" }, "primary": { "id": "id", "createdAt": "createdAt", "fields": { "foo": { "value": "string", "valueType": "ADDRESS" } }, "httpLink": "httpLink", "relationships": { "foo": { "cardinality": "cardinality", "objectType": "objectType", "values": [ "string" ] } }, "updatedAt": "updatedAt", "externalId": "externalId" }, "summary": { "fieldWriteCount": -9007199254740991, "syncRepointedCount": -9007199254740991, "warnings": [ "string" ] } } ``` ## Merge two contacts `client.merge.mergeContacts(MergeMergeContactsParamsbody, RequestOptionsoptions?): MergeMergeContactsResponse` **post** `/v1/contacts/merge` Merges two contacts into one. The primary contact retains its ID; the duplicate is soft-deleted. **[Required scopes](/using-the-api/scopes/):** `contacts:update` + `contacts:delete` **[Rate limit category](/using-the-api/rate-limits/):** Write ### Parameters - `body: MergeMergeContactsParams` - `duplicateId: string` ID of the duplicate record to merge into the primary and then discard. - `primaryId: string` ID of the record to keep. - `fieldResolutions?: Record` Per-field resolution overrides keyed by attribute slug. - `"primary" | "duplicate"` - `"primary"` - `"duplicate"` - `Value` - `value: string | number | boolean | 3 more | null` - `string` - `number` - `boolean` - `Array` - `Address` - `city?: string | null` City name. - `country?: string | null` 2-letter ISO 3166-1 alpha-2 country code. - `latitude?: number | null` Latitude coordinate. - `longitude?: number | null` Longitude coordinate. - `postalCode?: string | null` Postal or ZIP code. - `state?: string | null` State or province. - `street?: string | null` Street address line 1. - `street2?: string | null` Street address line 2. - `FullName` - `firstName?: string | null` The contact's first name. - `lastName?: string | null` The contact's last name. - `options?: Options` - `multiSelectUnion?: boolean` When true, multi-select fields are merged by union rather than primary-takes-all. ### Returns - `MergeMergeContactsResponse` - `merge: Merge` - `id: string` Unique identifier for the merge operation. - `status: string` Current status of the merge: `cleanup_pending`, `done`, or `failed`. - `primary: Primary` - `id: string` Unique identifier for the entity. - `createdAt: string` ISO 8601 timestamp of when the entity was created. - `fields: Record` 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 | number | boolean | 3 more | null` The field value, or null if unset. - `string` - `number` - `boolean` - `Array` - `Address` - `city?: string | null` City name. - `country?: string | null` 2-letter ISO 3166-1 alpha-2 country code. - `latitude?: number | null` Latitude coordinate. - `longitude?: number | null` Longitude coordinate. - `postalCode?: string | null` Postal or ZIP code. - `state?: string | null` State or province. - `street?: string | null` Street address line 1. - `street2?: string | null` Street address line 2. - `FullName` - `firstName?: string | null` The contact's first name. - `lastName?: string | null` The contact's last name. - `valueType: "ADDRESS" | "CHECKBOX" | "CURRENCY" | 12 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"` - `"HTML"` - `httpLink: string | null` URL to view the entity in the Lightfield web app, or null. - `relationships: Record` 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` IDs of the related entities. - `updatedAt: string | null` ISO 8601 timestamp of when the entity was last updated, or null. - `externalId?: string | null` External identifier for the entity, or null if unset. - `summary: Summary` - `fieldWriteCount: number` Number of attribute fields written onto the primary record. - `syncRepointedCount: number` Number of related records re-pointed from the duplicate to the primary. - `warnings: Array` Non-fatal warnings from the merge (e.g. skipped transfers). ### Example ```typescript import Lightfield from 'lightfield'; const client = new Lightfield({ apiKey: 'My API Key', }); const mergeMergeContactsResponse = await client.merge.mergeContacts({ duplicateId: 'duplicateId', primaryId: 'primaryId', }); console.log(mergeMergeContactsResponse.merge); ``` #### Response ```json { "merge": { "id": "id", "status": "status" }, "primary": { "id": "id", "createdAt": "createdAt", "fields": { "foo": { "value": "string", "valueType": "ADDRESS" } }, "httpLink": "httpLink", "relationships": { "foo": { "cardinality": "cardinality", "objectType": "objectType", "values": [ "string" ] } }, "updatedAt": "updatedAt", "externalId": "externalId" }, "summary": { "fieldWriteCount": -9007199254740991, "syncRepointedCount": -9007199254740991, "warnings": [ "string" ] } } ``` ## Merge two opportunities `client.merge.mergeOpportunities(MergeMergeOpportunitiesParamsbody, RequestOptionsoptions?): MergeMergeOpportunitiesResponse` **post** `/v1/opportunities/merge` Merges two opportunities into one. The primary opportunity retains its ID; the duplicate is soft-deleted. Both opportunities must belong to the same account. **[Required scopes](/using-the-api/scopes/):** `opportunities:update` + `opportunities:delete` **[Rate limit category](/using-the-api/rate-limits/):** Write ### Parameters - `body: MergeMergeOpportunitiesParams` - `duplicateId: string` ID of the duplicate record to merge into the primary and then discard. - `primaryId: string` ID of the record to keep. - `fieldResolutions?: Record` Per-field resolution overrides keyed by attribute slug. - `"primary" | "duplicate"` - `"primary"` - `"duplicate"` - `Value` - `value: string | number | boolean | 3 more | null` - `string` - `number` - `boolean` - `Array` - `Address` - `city?: string | null` City name. - `country?: string | null` 2-letter ISO 3166-1 alpha-2 country code. - `latitude?: number | null` Latitude coordinate. - `longitude?: number | null` Longitude coordinate. - `postalCode?: string | null` Postal or ZIP code. - `state?: string | null` State or province. - `street?: string | null` Street address line 1. - `street2?: string | null` Street address line 2. - `FullName` - `firstName?: string | null` The contact's first name. - `lastName?: string | null` The contact's last name. - `options?: Options` - `multiSelectUnion?: boolean` When true, multi-select fields are merged by union rather than primary-takes-all. ### Returns - `MergeMergeOpportunitiesResponse` - `merge: Merge` - `id: string` Unique identifier for the merge operation. - `status: string` Current status of the merge: `cleanup_pending`, `done`, or `failed`. - `primary: Primary` - `id: string` Unique identifier for the entity. - `createdAt: string` ISO 8601 timestamp of when the entity was created. - `fields: Record` 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 | number | boolean | 3 more | null` The field value, or null if unset. - `string` - `number` - `boolean` - `Array` - `Address` - `city?: string | null` City name. - `country?: string | null` 2-letter ISO 3166-1 alpha-2 country code. - `latitude?: number | null` Latitude coordinate. - `longitude?: number | null` Longitude coordinate. - `postalCode?: string | null` Postal or ZIP code. - `state?: string | null` State or province. - `street?: string | null` Street address line 1. - `street2?: string | null` Street address line 2. - `FullName` - `firstName?: string | null` The contact's first name. - `lastName?: string | null` The contact's last name. - `valueType: "ADDRESS" | "CHECKBOX" | "CURRENCY" | 12 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"` - `"HTML"` - `httpLink: string | null` URL to view the entity in the Lightfield web app, or null. - `relationships: Record` 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` IDs of the related entities. - `updatedAt: string | null` ISO 8601 timestamp of when the entity was last updated, or null. - `externalId?: string | null` External identifier for the entity, or null if unset. - `summary: Summary` - `fieldWriteCount: number` Number of attribute fields written onto the primary record. - `syncRepointedCount: number` Number of related records re-pointed from the duplicate to the primary. - `warnings: Array` Non-fatal warnings from the merge (e.g. skipped transfers). ### Example ```typescript import Lightfield from 'lightfield'; const client = new Lightfield({ apiKey: 'My API Key', }); const mergeMergeOpportunitiesResponse = await client.merge.mergeOpportunities({ duplicateId: 'duplicateId', primaryId: 'primaryId', }); console.log(mergeMergeOpportunitiesResponse.merge); ``` #### Response ```json { "merge": { "id": "id", "status": "status" }, "primary": { "id": "id", "createdAt": "createdAt", "fields": { "foo": { "value": "string", "valueType": "ADDRESS" } }, "httpLink": "httpLink", "relationships": { "foo": { "cardinality": "cardinality", "objectType": "objectType", "values": [ "string" ] } }, "updatedAt": "updatedAt", "externalId": "externalId" }, "summary": { "fieldWriteCount": -9007199254740991, "syncRepointedCount": -9007199254740991, "warnings": [ "string" ] } } ``` ## Merge two custom object records `client.merge.mergeObjectValues(stringentitySlug, MergeMergeObjectValuesParamsbody, RequestOptionsoptions?): MergeMergeObjectValuesResponse` **post** `/v1/objects/{entitySlug}/merge` Merges two records of the specified custom object type into one. The primary record retains its ID; the duplicate is soft-deleted. Both records must belong to the custom object type named in the path. **[Required scopes](/using-the-api/scopes/):** `custom_objects:update` + `custom_objects:delete` **[Rate limit category](/using-the-api/rate-limits/):** Write ### Parameters - `entitySlug: string` The slug of the custom object type. - `body: MergeMergeObjectValuesParams` - `duplicateId: string` ID of the duplicate record to merge into the primary and then discard. - `primaryId: string` ID of the record to keep. - `fieldResolutions?: Record` Per-field resolution overrides keyed by attribute slug. - `"primary" | "duplicate"` - `"primary"` - `"duplicate"` - `Value` - `value: string | number | boolean | 3 more | null` - `string` - `number` - `boolean` - `Array` - `Address` - `city?: string | null` City name. - `country?: string | null` 2-letter ISO 3166-1 alpha-2 country code. - `latitude?: number | null` Latitude coordinate. - `longitude?: number | null` Longitude coordinate. - `postalCode?: string | null` Postal or ZIP code. - `state?: string | null` State or province. - `street?: string | null` Street address line 1. - `street2?: string | null` Street address line 2. - `FullName` - `firstName?: string | null` The contact's first name. - `lastName?: string | null` The contact's last name. - `options?: Options` - `multiSelectUnion?: boolean` When true, multi-select fields are merged by union rather than primary-takes-all. ### Returns - `MergeMergeObjectValuesResponse` - `merge: Merge` - `id: string` Unique identifier for the merge operation. - `status: string` Current status of the merge: `cleanup_pending`, `done`, or `failed`. - `primary: Primary` - `id: string` Unique identifier for the entity. - `createdAt: string` ISO 8601 timestamp of when the entity was created. - `fields: Record` 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 | number | boolean | 3 more | null` The field value, or null if unset. - `string` - `number` - `boolean` - `Array` - `Address` - `city?: string | null` City name. - `country?: string | null` 2-letter ISO 3166-1 alpha-2 country code. - `latitude?: number | null` Latitude coordinate. - `longitude?: number | null` Longitude coordinate. - `postalCode?: string | null` Postal or ZIP code. - `state?: string | null` State or province. - `street?: string | null` Street address line 1. - `street2?: string | null` Street address line 2. - `FullName` - `firstName?: string | null` The contact's first name. - `lastName?: string | null` The contact's last name. - `valueType: "ADDRESS" | "CHECKBOX" | "CURRENCY" | 12 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"` - `"HTML"` - `httpLink: string | null` URL to view the entity in the Lightfield web app, or null. - `relationships: Record` 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` IDs of the related entities. - `updatedAt: string | null` ISO 8601 timestamp of when the entity was last updated, or null. - `externalId?: string | null` External identifier for the entity, or null if unset. - `summary: Summary` - `fieldWriteCount: number` Number of attribute fields written onto the primary record. - `syncRepointedCount: number` Number of related records re-pointed from the duplicate to the primary. - `warnings: Array` Non-fatal warnings from the merge (e.g. skipped transfers). ### Example ```typescript import Lightfield from 'lightfield'; const client = new Lightfield({ apiKey: 'My API Key', }); const mergeMergeObjectValuesResponse = await client.merge.mergeObjectValues('entitySlug', { duplicateId: 'duplicateId', primaryId: 'primaryId', }); console.log(mergeMergeObjectValuesResponse.merge); ``` #### Response ```json { "merge": { "id": "id", "status": "status" }, "primary": { "id": "id", "createdAt": "createdAt", "fields": { "foo": { "value": "string", "valueType": "ADDRESS" } }, "httpLink": "httpLink", "relationships": { "foo": { "cardinality": "cardinality", "objectType": "objectType", "values": [ "string" ] } }, "updatedAt": "updatedAt", "externalId": "externalId" }, "summary": { "fieldWriteCount": -9007199254740991, "syncRepointedCount": -9007199254740991, "warnings": [ "string" ] } } ``` ## Get merge status `client.merge.getMerge(stringid, RequestOptionsoptions?): MergeGetMergeResponse` **get** `/v1/merges/{id}` Returns the status and details of a merge operation by its ID. **[Rate limit category](/using-the-api/rate-limits/):** Read ### Parameters - `id: string` The merge operation ID. ### Returns - `MergeGetMergeResponse` - `id: string` Unique identifier for the merge operation. - `createdAt: string` ISO 8601 timestamp of when the merge was created. - `duplicateId: string` ID of the record that was merged into the primary and soft-deleted. - `entityType: string` The object type of the merged records (e.g. `account`, `contact`, `opportunity`, or a custom object slug). - `primaryId: string` ID of the record that was kept (the primary). - `status: string` Current status of the merge: `cleanup_pending`, `done`, or `failed`. - `updatedAt: string` ISO 8601 timestamp of when the merge was last updated. ### Example ```typescript import Lightfield from 'lightfield'; const client = new Lightfield({ apiKey: 'My API Key', }); const mergeGetMergeResponse = await client.merge.getMerge('id'); console.log(mergeGetMergeResponse.id); ``` #### Response ```json { "id": "id", "createdAt": "createdAt", "duplicateId": "duplicateId", "entityType": "entityType", "primaryId": "primaryId", "status": "status", "updatedAt": "updatedAt" } ``` ## Domain Types ### Merge Get Merge Response - `MergeGetMergeResponse` - `id: string` Unique identifier for the merge operation. - `createdAt: string` ISO 8601 timestamp of when the merge was created. - `duplicateId: string` ID of the record that was merged into the primary and soft-deleted. - `entityType: string` The object type of the merged records (e.g. `account`, `contact`, `opportunity`, or a custom object slug). - `primaryId: string` ID of the record that was kept (the primary). - `status: string` Current status of the merge: `cleanup_pending`, `done`, or `failed`. - `updatedAt: string` ISO 8601 timestamp of when the merge was last updated. ### Merge Merge Accounts Response - `MergeMergeAccountsResponse` - `merge: Merge` - `id: string` Unique identifier for the merge operation. - `status: string` Current status of the merge: `cleanup_pending`, `done`, or `failed`. - `primary: Primary` - `id: string` Unique identifier for the entity. - `createdAt: string` ISO 8601 timestamp of when the entity was created. - `fields: Record` 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 | number | boolean | 3 more | null` The field value, or null if unset. - `string` - `number` - `boolean` - `Array` - `Address` - `city?: string | null` City name. - `country?: string | null` 2-letter ISO 3166-1 alpha-2 country code. - `latitude?: number | null` Latitude coordinate. - `longitude?: number | null` Longitude coordinate. - `postalCode?: string | null` Postal or ZIP code. - `state?: string | null` State or province. - `street?: string | null` Street address line 1. - `street2?: string | null` Street address line 2. - `FullName` - `firstName?: string | null` The contact's first name. - `lastName?: string | null` The contact's last name. - `valueType: "ADDRESS" | "CHECKBOX" | "CURRENCY" | 12 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"` - `"HTML"` - `httpLink: string | null` URL to view the entity in the Lightfield web app, or null. - `relationships: Record` 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` IDs of the related entities. - `updatedAt: string | null` ISO 8601 timestamp of when the entity was last updated, or null. - `externalId?: string | null` External identifier for the entity, or null if unset. - `summary: Summary` - `fieldWriteCount: number` Number of attribute fields written onto the primary record. - `syncRepointedCount: number` Number of related records re-pointed from the duplicate to the primary. - `warnings: Array` Non-fatal warnings from the merge (e.g. skipped transfers). ### Merge Merge Contacts Response - `MergeMergeContactsResponse` - `merge: Merge` - `id: string` Unique identifier for the merge operation. - `status: string` Current status of the merge: `cleanup_pending`, `done`, or `failed`. - `primary: Primary` - `id: string` Unique identifier for the entity. - `createdAt: string` ISO 8601 timestamp of when the entity was created. - `fields: Record` 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 | number | boolean | 3 more | null` The field value, or null if unset. - `string` - `number` - `boolean` - `Array` - `Address` - `city?: string | null` City name. - `country?: string | null` 2-letter ISO 3166-1 alpha-2 country code. - `latitude?: number | null` Latitude coordinate. - `longitude?: number | null` Longitude coordinate. - `postalCode?: string | null` Postal or ZIP code. - `state?: string | null` State or province. - `street?: string | null` Street address line 1. - `street2?: string | null` Street address line 2. - `FullName` - `firstName?: string | null` The contact's first name. - `lastName?: string | null` The contact's last name. - `valueType: "ADDRESS" | "CHECKBOX" | "CURRENCY" | 12 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"` - `"HTML"` - `httpLink: string | null` URL to view the entity in the Lightfield web app, or null. - `relationships: Record` 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` IDs of the related entities. - `updatedAt: string | null` ISO 8601 timestamp of when the entity was last updated, or null. - `externalId?: string | null` External identifier for the entity, or null if unset. - `summary: Summary` - `fieldWriteCount: number` Number of attribute fields written onto the primary record. - `syncRepointedCount: number` Number of related records re-pointed from the duplicate to the primary. - `warnings: Array` Non-fatal warnings from the merge (e.g. skipped transfers). ### Merge Merge Object Values Response - `MergeMergeObjectValuesResponse` - `merge: Merge` - `id: string` Unique identifier for the merge operation. - `status: string` Current status of the merge: `cleanup_pending`, `done`, or `failed`. - `primary: Primary` - `id: string` Unique identifier for the entity. - `createdAt: string` ISO 8601 timestamp of when the entity was created. - `fields: Record` 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 | number | boolean | 3 more | null` The field value, or null if unset. - `string` - `number` - `boolean` - `Array` - `Address` - `city?: string | null` City name. - `country?: string | null` 2-letter ISO 3166-1 alpha-2 country code. - `latitude?: number | null` Latitude coordinate. - `longitude?: number | null` Longitude coordinate. - `postalCode?: string | null` Postal or ZIP code. - `state?: string | null` State or province. - `street?: string | null` Street address line 1. - `street2?: string | null` Street address line 2. - `FullName` - `firstName?: string | null` The contact's first name. - `lastName?: string | null` The contact's last name. - `valueType: "ADDRESS" | "CHECKBOX" | "CURRENCY" | 12 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"` - `"HTML"` - `httpLink: string | null` URL to view the entity in the Lightfield web app, or null. - `relationships: Record` 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` IDs of the related entities. - `updatedAt: string | null` ISO 8601 timestamp of when the entity was last updated, or null. - `externalId?: string | null` External identifier for the entity, or null if unset. - `summary: Summary` - `fieldWriteCount: number` Number of attribute fields written onto the primary record. - `syncRepointedCount: number` Number of related records re-pointed from the duplicate to the primary. - `warnings: Array` Non-fatal warnings from the merge (e.g. skipped transfers). ### Merge Merge Opportunities Response - `MergeMergeOpportunitiesResponse` - `merge: Merge` - `id: string` Unique identifier for the merge operation. - `status: string` Current status of the merge: `cleanup_pending`, `done`, or `failed`. - `primary: Primary` - `id: string` Unique identifier for the entity. - `createdAt: string` ISO 8601 timestamp of when the entity was created. - `fields: Record` 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 | number | boolean | 3 more | null` The field value, or null if unset. - `string` - `number` - `boolean` - `Array` - `Address` - `city?: string | null` City name. - `country?: string | null` 2-letter ISO 3166-1 alpha-2 country code. - `latitude?: number | null` Latitude coordinate. - `longitude?: number | null` Longitude coordinate. - `postalCode?: string | null` Postal or ZIP code. - `state?: string | null` State or province. - `street?: string | null` Street address line 1. - `street2?: string | null` Street address line 2. - `FullName` - `firstName?: string | null` The contact's first name. - `lastName?: string | null` The contact's last name. - `valueType: "ADDRESS" | "CHECKBOX" | "CURRENCY" | 12 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"` - `"HTML"` - `httpLink: string | null` URL to view the entity in the Lightfield web app, or null. - `relationships: Record` 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` IDs of the related entities. - `updatedAt: string | null` ISO 8601 timestamp of when the entity was last updated, or null. - `externalId?: string | null` External identifier for the entity, or null if unset. - `summary: Summary` - `fieldWriteCount: number` Number of attribute fields written onto the primary record. - `syncRepointedCount: number` Number of related records re-pointed from the duplicate to the primary. - `warnings: Array` Non-fatal warnings from the merge (e.g. skipped transfers).