/contacts

Returns a list of Contact objects.

Authentication

AuthorizationBearer

Token-based authentication with required prefix “Bearer”

Query parameters

account_idstringOptional

If provided, will only return contacts with this account.

created_afterdatetimeOptional

If provided, will only return objects created after this datetime.

created_beforedatetimeOptional

If provided, will only return objects created before this datetime.

cursorstringOptional

The pagination cursor value.

email_addressesstringOptional

If provided, will only return contacts matching the email addresses; multiple email_addresses can be separated by commas.

expandenumOptional

Which relations should be returned in expanded form. Multiple relation names should be comma separated without spaces.

Allowed values:

include_deleted_databooleanOptional

Indicates whether or not this object has been deleted in the third party platform. Full coverage deletion detection is a premium add-on. Native deletion detection is offered for free with limited coverage. Learn more.

include_remote_databooleanOptional

Whether to include the original data Merge fetched from the third-party to produce these models.

include_remote_fieldsbooleanOptional

Whether to include all remote fields, including fields that Merge did not map to common models, in a normalized format.

include_shell_databooleanOptional

Whether to include shell records. Shell records are empty records (they may contain some metadata but all other fields are null).

modified_afterdatetimeOptional

If provided, only objects synced by Merge after this date time will be returned.

modified_beforedatetimeOptional

If provided, only objects synced by Merge before this date time will be returned.

page_sizeintegerOptional

Number of results to return per page. The maximum limit is 100.

phone_numbersstringOptional

If provided, will only return contacts matching the phone numbers; multiple phone numbers can be separated by commas.

remote_idstringOptional

The API provider's ID for the given object.

Response

nextstring or null

previousstring or null

resultslist of objects or null

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

first_namestring or nullOptional

The contact's first name.

last_namestring or nullOptional

The contact's last name.

accountstring or nullOptionalformat: "uuid"

The contact's account.

email_addresseslist of objectsOptional

phone_numberslist of objectsOptional

last_activity_atdatetime or nullOptional

When the contact's last activity occurred.

remote_created_atdatetime or nullOptional

When the third party's contact was created.

remote_datalist of objects or nullOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

first_namestring or nullOptional

The contact's first name.

last_namestring or nullOptional

The contact's last name.

accountstring or nullOptionalformat: "uuid"

The contact's account.

email_addresseslist of objectsOptional

phone_numberslist of objectsOptional

last_activity_atdatetime or nullOptional

When the contact's last activity occurred.

remote_created_atdatetime or nullOptional

When the third party's contact was created.

remote_datalist of objects or nullOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

first_namestring or nullOptional

The contact's first name.

last_namestring or nullOptional

The contact's last name.

accountstring or nullOptionalformat: "uuid"

The contact's account.

email_addresseslist of objectsOptional

phone_numberslist of objectsOptional

remote_created_atdatetime or nullOptional

When the third party's contact was created.

remote_datalist of objects or nullOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

first_namestring or nullOptional

The contact's first name.

last_namestring or nullOptional

The contact's last name.

accountstring or nullOptionalformat: "uuid"

The contact's account.

addresseslist of objectsOptional

email_addresseslist of objectsOptional

phone_numberslist of objectsOptional

last_activity_atdatetime or nullOptional

When the contact's last activity occurred.

remote_created_atdatetime or nullOptional

When the third party's contact was created.

remote_datalist of objects or nullOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

first_namestring or nullOptional

The contact's first name.

last_namestring or nullOptional

The contact's last name.

accountstring or nullOptionalformat: "uuid"

The contact's account.

ownerstring or nullOptionalformat: "uuid"

The contact's owner.

addresseslist of objectsOptional

email_addresseslist of objectsOptional

phone_numberslist of objectsOptional

last_activity_atdatetime or nullOptional

When the contact's last activity occurred.

remote_created_atdatetime or nullOptional

When the third party's contact was created.

remote_datalist of objects or nullOptionalRead-only

remote_fieldslist of objectsOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

first_namestring or nullOptional

The contact's first name.

last_namestring or nullOptional

The contact's last name.

accountstring or nullOptionalformat: "uuid"

The contact's account.

email_addresseslist of objectsOptional

phone_numberslist of objectsOptional

remote_created_atdatetime or nullOptional

When the third party's contact was created.

remote_datalist of objects or nullOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

first_namestring or nullOptional

The contact's first name.

last_namestring or nullOptional

The contact's last name.

accountstring or nullOptionalformat: "uuid"

The contact's account.

addresseslist of objectsOptional

email_addresseslist of objectsOptional

phone_numberslist of objectsOptional

remote_created_atdatetime or nullOptional

When the third party's contact was created.

remote_datalist of objects or nullOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

first_namestring or nullOptional

The contact's first name.

last_namestring or nullOptional

The contact's last name.

accountstring or nullOptionalformat: "uuid"

The contact's account.

ownerstring or nullOptionalformat: "uuid"

The contact's owner.

addresseslist of objectsOptional

email_addresseslist of objectsOptional

phone_numberslist of objectsOptional

remote_created_atdatetime or nullOptional

When the third party's contact was created.

remote_datalist of objects or nullOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

first_namestring or nullOptional

The contact's first name.

last_namestring or nullOptional

The contact's last name.

accountstring or nullOptionalformat: "uuid"

The contact's account.

addresseslist of objectsOptional

email_addresseslist of objectsOptional

phone_numberslist of objectsOptional

last_activity_atdatetime or nullOptional

When the contact's last activity occurred.

remote_created_atdatetime or nullOptional

When the third party's contact was created.

remote_datalist of objects or nullOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

first_namestring or nullOptional

The contact's first name.

last_namestring or nullOptional

The contact's last name.

accountstring or nullOptionalformat: "uuid"

The contact's account.

ownerstring or nullOptionalformat: "uuid"

The contact's owner.

addresseslist of objectsOptional

email_addresseslist of objectsOptional

phone_numberslist of objectsOptional

last_activity_atdatetime or nullOptional

When the contact's last activity occurred.

remote_created_atdatetime or nullOptional

When the third party's contact was created.

remote_datalist of objects or nullOptionalRead-only

remote_fieldslist of objectsOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

first_namestring or nullOptional

The contact's first name.

last_namestring or nullOptional

The contact's last name.

accountstring or nullOptionalformat: "uuid"

The contact's account.

addresseslist of objectsOptional

email_addresseslist of objectsOptional

phone_numberslist of objectsOptional

remote_created_atdatetime or nullOptional

When the third party's contact was created.

remote_datalist of objects or nullOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

first_namestring or nullOptional

The contact's first name.

last_namestring or nullOptional

The contact's last name.

accountstring or nullOptionalformat: "uuid"

The contact's account.

ownerstring or nullOptionalformat: "uuid"

The contact's owner.

addresseslist of objectsOptional

email_addresseslist of objectsOptional

phone_numberslist of objectsOptional

last_activity_atdatetime or nullOptional

When the contact's last activity occurred.

remote_created_atdatetime or nullOptional

When the third party's contact was created.

remote_datalist of objects or nullOptionalRead-only

remote_fieldslist of objectsOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

first_namestring or nullOptional

The contact's first name.

last_namestring or nullOptional

The contact's last name.

accountstring or nullOptionalformat: "uuid"

The contact's account.

addresseslist of objectsOptional

email_addresseslist of objectsOptional

phone_numberslist of objectsOptional

remote_created_atdatetime or nullOptional

When the third party's contact was created.

remote_datalist of objects or nullOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

first_namestring or nullOptional

The contact's first name.

last_namestring or nullOptional

The contact's last name.

accountstring or nullOptionalformat: "uuid"

The contact's account.

addresseslist of objectsOptional

email_addresseslist of objectsOptional

phone_numberslist of objectsOptional

remote_created_atdatetime or nullOptional

When the third party's contact was created.

remote_datalist of objects or nullOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

first_namestring or nullOptional

The contact's first name.

last_namestring or nullOptional

The contact's last name.

accountstring or nullOptionalformat: "uuid"

The contact's account.

email_addresseslist of objectsOptional

phone_numberslist of objectsOptional

last_activity_atdatetime or nullOptional

When the contact's last activity occurred.

remote_created_atdatetime or nullOptional

When the third party's contact was created.

remote_datalist of objects or nullOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

first_namestring or nullOptional

The contact's first name.

last_namestring or nullOptional

The contact's last name.

accountstring or nullOptionalformat: "uuid"

The contact's account.

addresseslist of objectsOptional

email_addresseslist of objectsOptional

phone_numberslist of objectsOptional

remote_created_atdatetime or nullOptional

When the third party's contact was created.

remote_datalist of objects or nullOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

first_namestring or nullOptional

The contact's first name.

last_namestring or nullOptional

The contact's last name.

accountstring or nullOptionalformat: "uuid"

The contact's account.

ownerstring or nullOptionalformat: "uuid"

The contact's owner.

addresseslist of objectsOptional

email_addresseslist of objectsOptional

phone_numberslist of objectsOptional

last_activity_atdatetime or nullOptional

When the contact's last activity occurred.

remote_created_atdatetime or nullOptional

When the third party's contact was created.

remote_datalist of objects or nullOptionalRead-only

remote_fieldslist of objectsOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

first_namestring or nullOptional

The contact's first name.

last_namestring or nullOptional

The contact's last name.

accountstring or nullOptionalformat: "uuid"

The contact's account.

email_addresseslist of objectsOptional

phone_numberslist of objectsOptional

last_activity_atdatetime or nullOptional

When the contact's last activity occurred.

remote_created_atdatetime or nullOptional

When the third party's contact was created.

remote_datalist of objects or nullOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

first_namestring or nullOptional

The contact's first name.

last_namestring or nullOptional

The contact's last name.

accountstring or nullOptionalformat: "uuid"

The contact's account.

email_addresseslist of objectsOptional

phone_numberslist of objectsOptional

last_activity_atdatetime or nullOptional

When the contact's last activity occurred.

remote_created_atdatetime or nullOptional

When the third party's contact was created.

remote_datalist of objects or nullOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

first_namestring or nullOptional

The contact's first name.

last_namestring or nullOptional

The contact's last name.

accountstring or nullOptionalformat: "uuid"

The contact's account.

email_addresseslist of objectsOptional

phone_numberslist of objectsOptional

remote_created_atdatetime or nullOptional

When the third party's contact was created.

remote_datalist of objects or nullOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

first_namestring or nullOptional

The contact's first name.

last_namestring or nullOptional

The contact's last name.

accountstring or nullOptionalformat: "uuid"

The contact's account.

addresseslist of objectsOptional

email_addresseslist of objectsOptional

phone_numberslist of objectsOptional

last_activity_atdatetime or nullOptional

When the contact's last activity occurred.

remote_created_atdatetime or nullOptional

When the third party's contact was created.

remote_datalist of objects or nullOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

first_namestring or nullOptional

The contact's first name.

last_namestring or nullOptional

The contact's last name.

accountstring or nullOptionalformat: "uuid"

The contact's account.

ownerstring or nullOptionalformat: "uuid"

The contact's owner.

addresseslist of objectsOptional

email_addresseslist of objectsOptional

phone_numberslist of objectsOptional

last_activity_atdatetime or nullOptional

When the contact's last activity occurred.

remote_created_atdatetime or nullOptional

When the third party's contact was created.

remote_datalist of objects or nullOptionalRead-only

remote_fieldslist of objectsOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

first_namestring or nullOptional

The contact's first name.

last_namestring or nullOptional

The contact's last name.

accountstring or nullOptionalformat: "uuid"

The contact's account.

email_addresseslist of objectsOptional

phone_numberslist of objectsOptional

remote_created_atdatetime or nullOptional

When the third party's contact was created.

remote_datalist of objects or nullOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

first_namestring or nullOptional

The contact's first name.

last_namestring or nullOptional

The contact's last name.

accountstring or nullOptionalformat: "uuid"

The contact's account.

addresseslist of objectsOptional

email_addresseslist of objectsOptional

phone_numberslist of objectsOptional

remote_created_atdatetime or nullOptional

When the third party's contact was created.

remote_datalist of objects or nullOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

first_namestring or nullOptional

The contact's first name.

last_namestring or nullOptional

The contact's last name.

accountstring or nullOptionalformat: "uuid"

The contact's account.

ownerstring or nullOptionalformat: "uuid"

The contact's owner.

addresseslist of objectsOptional

email_addresseslist of objectsOptional

phone_numberslist of objectsOptional

remote_created_atdatetime or nullOptional

When the third party's contact was created.

remote_datalist of objects or nullOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

first_namestring or nullOptional

The contact's first name.

last_namestring or nullOptional

The contact's last name.

accountstring or nullOptionalformat: "uuid"

The contact's account.

addresseslist of objectsOptional

email_addresseslist of objectsOptional

phone_numberslist of objectsOptional

last_activity_atdatetime or nullOptional

When the contact's last activity occurred.

remote_created_atdatetime or nullOptional

When the third party's contact was created.

remote_datalist of objects or nullOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

first_namestring or nullOptional

The contact's first name.

last_namestring or nullOptional

The contact's last name.

accountstring or nullOptionalformat: "uuid"

The contact's account.

ownerstring or nullOptionalformat: "uuid"

The contact's owner.

addresseslist of objectsOptional

email_addresseslist of objectsOptional

phone_numberslist of objectsOptional

last_activity_atdatetime or nullOptional

When the contact's last activity occurred.

remote_created_atdatetime or nullOptional

When the third party's contact was created.

remote_datalist of objects or nullOptionalRead-only

remote_fieldslist of objectsOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

first_namestring or nullOptional

The contact's first name.

last_namestring or nullOptional

The contact's last name.

accountstring or nullOptionalformat: "uuid"

The contact's account.

addresseslist of objectsOptional

email_addresseslist of objectsOptional

phone_numberslist of objectsOptional

remote_created_atdatetime or nullOptional

When the third party's contact was created.

remote_datalist of objects or nullOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

first_namestring or nullOptional

The contact's first name.

last_namestring or nullOptional

The contact's last name.

accountstring or nullOptionalformat: "uuid"

The contact's account.

ownerstring or nullOptionalformat: "uuid"

The contact's owner.

addresseslist of objectsOptional

email_addresseslist of objectsOptional

phone_numberslist of objectsOptional

last_activity_atdatetime or nullOptional

When the contact's last activity occurred.

remote_created_atdatetime or nullOptional

When the third party's contact was created.

remote_datalist of objects or nullOptionalRead-only

remote_fieldslist of objectsOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

first_namestring or nullOptional

The contact's first name.

last_namestring or nullOptional

The contact's last name.

accountstring or nullOptionalformat: "uuid"

The contact's account.

addresseslist of objectsOptional

email_addresseslist of objectsOptional

phone_numberslist of objectsOptional

remote_created_atdatetime or nullOptional

When the third party's contact was created.

remote_datalist of objects or nullOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

first_namestring or nullOptional

The contact's first name.

last_namestring or nullOptional

The contact's last name.

accountstring or nullOptionalformat: "uuid"

The contact's account.

addresseslist of objectsOptional

email_addresseslist of objectsOptional

phone_numberslist of objectsOptional

remote_created_atdatetime or nullOptional

When the third party's contact was created.

remote_datalist of objects or nullOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

first_namestring or nullOptional

The contact's first name.

last_namestring or nullOptional

The contact's last name.

accountstring or nullOptionalformat: "uuid"

The contact's account.

email_addresseslist of objectsOptional

phone_numberslist of objectsOptional

last_activity_atdatetime or nullOptional

When the contact's last activity occurred.

remote_created_atdatetime or nullOptional

When the third party's contact was created.

remote_datalist of objects or nullOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

first_namestring or nullOptional

The contact's first name.

last_namestring or nullOptional

The contact's last name.

accountstring or nullOptionalformat: "uuid"

The contact's account.

addresseslist of objectsOptional

email_addresseslist of objectsOptional

phone_numberslist of objectsOptional

remote_created_atdatetime or nullOptional

When the third party's contact was created.

remote_datalist of objects or nullOptionalRead-only

Supported response fields

remote_idstring or nullOptional

The third-party API ID of the matching object.

first_namestring or nullOptional

The contact's first name.

last_namestring or nullOptional

The contact's last name.

accountstring or nullOptionalformat: "uuid"

The contact's account.

ownerstring or nullOptionalformat: "uuid"

The contact's owner.

addresseslist of objectsOptional

email_addresseslist of objectsOptional

phone_numberslist of objectsOptional

last_activity_atdatetime or nullOptional

When the contact's last activity occurred.

remote_created_atdatetime or nullOptional

When the third party's contact was created.

remote_datalist of objects or nullOptionalRead-only

remote_fieldslist of objectsOptionalRead-only

1	curl -G https://api.merge.dev/api/crm/v1/contacts \
2	-H "X-Account-Token: X-Account-Token" \
3	-H "Authorization: Bearer <token>" \
4	-d account_id=account_id \
5	-d cursor=cD0yMDIxLTAxLTA2KzAzJTNBMjQlM0E1My40MzQzMjYlMkIwMCUzQTAw \
6	--data-urlencode expand=account,owner

1	{
2	"next": "cD0yMDIxLTAxLTA2KzAzJTNBMjQlM0E1My40MzQzMjYlMkIwMCUzQTAw",
3	"previous": "cj1sZXdwd2VycWVtY29zZnNkc2NzUWxNMEUxTXk0ME16UXpNallsTWtJ",
4	"results": [
5	{
6	"id": "550e8400-e29b-41d4-a716-446655440000",
7	"remote_id": "19202938",
8	"created_at": "2021-09-15T00:00:00Z",
9	"modified_at": "2021-10-16T00:00:00Z",
10	"first_name": "Gil",
11	"last_name": "Feig",
12	"account": "0958cbc6-6040-430a-848e-aafacbadf4ae",
13	"owner": "b8fbfc30-0982-420e-8c20-dab07b70b9d6",
14	"addresses": [
15	{
16	"created_at": "2021-09-15T00:00:00Z",
17	"modified_at": "2021-10-16T00:00:00Z",
18	"street_1": "50 Bowling Green Dr",
19	"street_2": "Golden Gate Park",
20	"city": "San Francisco",
21	"state": "CA",
22	"postal_code": "94122",
23	"country": "US",
24	"address_type": "BILLING"
25	}
26	],
27	"email_addresses": [
28	{
29	"email_address": "hello@merge.dev",
30	"email_address_type": "Work"
31	}
32	],
33	"phone_numbers": [
34	{
35	"created_at": "2021-09-15T00:00:00Z",
36	"modified_at": "2021-10-16T00:00:00Z",
37	"phone_number": "+13785579223",
38	"phone_number_type": "Mobile"
39	}
40	],
41	"last_activity_at": "2022-02-10T00:00:00Z",
42	"remote_created_at": "2021-11-10T00:00:00Z",
43	"remote_was_deleted": true,
44	"field_mappings": {
45	"organization_defined_targets": {
46	"custom_key": "custom_value"
47	},
48	"linked_account_defined_targets": {
49	"custom_key": "custom_value"
50	}
51	},
52	"remote_data": [
53	{
54	"path": "/contacts"
55	}
56	],
57	"remote_fields": [
58	{
59	"remote_field_class": {
60	"id": "string",
61	"display_name": "string",
62	"remote_key_name": "string",
63	"description": "string",
64	"is_custom": true,
65	"is_common_model_field": true,
66	"is_required": true,
67	"field_type": "string",
68	"field_format": "string",
69	"field_choices": [
70	"string"
71	],
72	"item_schema": {
73	"item_type": "string",
74	"item_format": "string",
75	"item_choices": [
76	"string"
77	]
78	}
79	},
80	"value": "string"
81	}
82	]
83	}
84	]
85	}

Authentication

Headers

Query parameters

Response

Field support by integration

Field support by integration