Contacts
GET - /crm/contacts
Fetch a page of contacts from the CRM Vendor, and give you a pageToken for the next page if there is one
Headers
user-id-from-vendor
required
string
Your user's ID from the vendor
URL Parameters
pageID
optional
string
The pagination ID from the previous request
sortBy
optional
created
updated
Sort the results. Note: some vendors have a stricter rate limitation when sorting the records (Hubspot for example). If you do not care about sorting, it is preferable to leave the field undefined.
Responses
200
vendor
required
Atlassian
Clickup
Dropbox
Google
Hubspot
Microsoft
Notion
Salesforce
Slack
data
required
array of object
id
required
string
createdAt
optional
string
The creation date as an ISO string
updatedAt
optional
string
The last update date as an ISO string
lastActivity
optional
string
The last activity date as an ISO string
firstName
optional
string
lastName
optional
string
fullName
optional
string
jobTitle
optional
string
companyIDs
required
array of string
The company ID if this contact is associated with a company
telephones
required
array of object
number
required
string
type
optional
string
addresses
required
array of object
street
optional
string
city
optional
string
state
optional
string
addressType
optional
string
postalCode
optional
string
country
optional
string
ISO letters for country
emails
required
array of object
email
required
string
The emails associated with the contact
nextPage
required
object
pageID
optional
string
The next page ID, is undefined when there is no more pages
GET - /crm/contact
Fetch a single company from the vendor using the ID
Headers
user-id-from-vendor
required
string
Your user's ID from the vendor
URL Parameters
contactID
required
string
The ID from the vendor of the contact you want to retrieve
Responses
200
vendor
required
Atlassian
Clickup
Dropbox
Google
Hubspot
Microsoft
Notion
Salesforce
Slack
data
required
object
id
required
string
createdAt
optional
string
The creation date as an ISO string
updatedAt
optional
string
The last update date as an ISO string
lastActivity
optional
string
The last activity date as an ISO string
firstName
optional
string
lastName
optional
string
fullName
optional
string
jobTitle
optional
string
companyIDs
required
array of string
The company ID if this contact is associated with a company
telephones
required
array of object
number
required
string
type
optional
string
addresses
required
array of object
street
optional
string
city
optional
string
state
optional
string
addressType
optional
string
postalCode
optional
string
country
optional
string
ISO letters for country
emails
required
array of object
email
required
string
The emails associated with the contact