Method Details
HTTP Methods:
GET
Response Format:
json
Requires Authentication?
Yes
Rate Limited?
Headers
Products:
Marketing & CRM
crm.objects.contacts.read
The get recently updated and created contacts endpoint is used to return information about all contacts for a given account that were updated or created in the last 30 days.
Use case for this endpoint: This endpoint is useful for integrations that need to track changes to contacts and synchronize those changes to an external system.
Response details
A paginated list of contacts will be returned to you, with a maximum of 100 contacts per page, as specified by the "count" parameter. The endpoint only scrolls back in time 30 days.
Please Note Pay close attention to the following fields:
- The "has-more" field, which lets you know whether there are more contacts that you can pull from this portal.
- The "vid-offset" and "time-offset" fields, which let you know where you are in the list of contacts.
- You can then use the "vid-offset" or "time-offset" fields in the "vidOffset" or "timeOffset" parameters described below.
The response is sorted in descending order by last modified date; the most recently modified record is returned first.
This endpoint does not return a list of all changes to contacts. It simply provides a reverse chronological list of changed contacts, sorted by lastmodifieddate. This means if a contact was modified yesterday and again this morning, it would only show up in the list once.
Notes: If you're only looking for new records (and not modified records), you can use the get recently created contacts endpoint.