Access to the Contacts API requires a valid access token. Use OAuth 2.0 where supported and request the necessary scopes such as contacts.readonly to read contact data.
Zapier App Connector authenticates against the backend through your connected account. You typically authorize once and tokens refresh automatically as needed.
GET /contacts/:contactId; GET /contacts/:contactId/tasks; GET /contacts/:contactId/tasks/:taskId; GET /contacts/:contactId/notes; GET /contacts/:contactId/notes/:id; GET /contacts/:contactId/appointments; GET /contacts/; GET /contacts/business/:businessId; POST /contacts/; PUT /contacts/:contactId; DELETE /contacts/:contactId; POST /contacts/:contactId/tasks; PUT /contacts/:contactId/tasks/:taskId; PUT /contacts/:contactId/tasks/:taskId/completed; DELETE /contacts/:contactId/tasks/:taskId; POST /contacts/:contactId/tags
Trigger: retrieve a contact by ID using GET /contacts/:contactId
Actions: return contact data and optionally fetch related tasks and notes
GET /contacts/:contactId
Key fields: contactId, name, email, phone
Trigger: fetch a paged list of contacts
Actions: list contacts with filters and handle pagination
GET /contacts/
Key fields: contactId, firstName, lastName, email
Trigger: when a new contact is created or an existing contact is updated
Actions: create a contact with POST /contacts/ and update with PUT /contacts/:contactId
POST /contacts/; PUT /contacts/:contactId
Key fields: contactId, name, email, phone
No coding required for basic data retrieval and automation via Zapier
Easily connect the Contacts API to apps with no server side development
Extend data with tags, notes and tasks to enrich workflows without custom code
A quick glossary of terms used in this guide covering authentication endpoints and common field names
Definition: Verifying identity to grant API access, typically via OAuth 2.0 tokens
Definition: A specific URL path that performs an action in the API
Definition: Methods for authenticating API requests using tokens or keys
Definition: How results are divided into pages using tokens or page numbers
Set up a zap to create a new contact in the CRM when a signup occurs, pulling name and email and tagging automatically.
When a contact task or note changes, update a dashboard in real time.
Route contacts to campaigns using businessId and tagging in Zapier automations.
Obtain OAuth tokens or API keys and securely store credentials
Select desired endpoints such as GET /contacts/:contactId and GET /contacts/
Create Zapier triggers and actions that map Contact fields to your apps
Authentication uses OAuth 2.0 tokens or API keys. Include a valid access token in the Authorization header for each request. Ensure tokens are refreshed before they expire. For read only access, request the correct scope such as contacts.readonly.
Read only endpoints include retrieving contacts, notes, tasks and appointments. These do not modify data. If you need to create or update records, you must use write endpoints with appropriate authentication and scopes.
To create a contact use POST /contacts/ with required fields such as name and email. To update a contact use PUT /contacts/:contactId with fields to modify; ensure you have proper permissions and handle concurrency.
List endpoints support pagination. Use page size and page tokens as documented and handle paging in your Zapier app. If limits are hit, implement cursors or paging parameters and respect rate limits.
No code is required to get started with Zapier App Connector. You can set up triggers and actions using the built in UI. For complex workflows consider filters and paths to map fields between apps.
Common errors include invalid token, insufficient scope, and missing required fields. Check the error response for codes and messages. Retry with exponential backoff and ensure credentials are valid.
For a full endpoint list and field descriptions, consult the API docs and developer portal. You can also view sample requests and code snippets in the integration guides.
Due to high volume, we will be upgrading our server soon!
Complete Operations Catalog - 126 Actions & Triggers
