Contacts & events
email_upsert_contact
Create or update a contact (attributes shallow-merge; tags REPLACE the set when given).
write email_upsert_contact
Create or update a contact (attributes shallow-merge; tags REPLACE the set when given). Attributes drive automation filters (e.g. contact.attributes.city) and template personalization; timezone (IANA) controls send windows. Tags are labels a segment/filter matches via contains on path contact.tags.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
email | string | Yes | |
externalId | string | No | |
attributes | object | No | |
tags | string[] | No | |
projectId | string | No | Target company (project id). Org-scoped tokens only; call email_list_projects first. |