Actions210
- Contact Actions
- Contact Applied Tag Actions
- Contact Tag Actions
- Course Actions
- Course Enrollment Actions
- Course Lesson Actions
- Course Section Actions
- Form Actions
- Form Field Actions
- Form Field Option Actions
- Form Field Set Actions
- Form Submission Actions
- Form Submission Answer Actions
- Form Submission (Legacy) Actions
- Fulfillment Actions
- Fulfillment Location Actions
- Funnel Actions
- Funnel Tag Actions
- Image Actions
- Lesson Completion Actions
- Opportunity Note Actions
- Order Actions
- Order Applied Tag Actions
- Order Invoice Actions
- Order Restock Actions
- Order Tag Actions
- Order Transaction Actions
- Page Actions
- Pipeline Stage Actions
- Product Actions
- Product Collection Actions
- Product Price Actions
- Product Tag Actions
- Product Variant Actions
- Sales Opportunity Actions
- Sales Pipeline Actions
- Scheduled Event Actions
- Shipping Location Group Actions
- Shipping Package Actions
- Shipping Profile Actions
- Shipping Rate Actions
- Shipping Rate Name Actions
- Shipping Zone Actions
- Site Actions
- Store Actions
- Style Actions
- Team Actions
- Theme Actions
- User Actions
- Webhook Endpoint Actions
- Webhook Event Actions
- Workspace Actions
Contact → Upsert
AI-generatedSummary
Upsert a contact in a workspace, creating it if it does not exist or updating it if it does, based on email.
Inputs
- workspaceId (required) — The ID of the workspace the contact belongs to.
- email (required) — The email address of the contact.
- firstName — The first name of the contact.
- lastName — The last name of the contact.
- phoneNumber — The phone number of the contact.
- additionalFields — Additional field key-value pairs for custom data.
- state — State or province of the contact address.
- tags — Comma-separated list of tags to apply to the contact.
- timeZone — The IANA time zone of the contact (e.g. "America/New_York").
- zip — Postal / zip code of the contact address.
Output shape
a single contact record
Returns the created or updated contact object with fields such as contactId, email, and workspaceId; errors are wrapped in an envelope.
Examples
Example 1: Create a new contact in workspace W001
{"workspaceId":"W001","email":"john@example.com"}
Example 2: Update an existing contact by email in workspace W001
{"workspaceId":"W001","email":"john@example.com","firstName":"John","lastName":"Doe"}
Example 3: Upsert a contact with custom fields and tags
{"workspaceId":"W001","email":"jane@example.com","additionalFields":{"addressLine1":"123 Main St"},"tags":"VIP,Marketing"}