Contacts

Create or update a contact

POST/v1/contactsrequires contact:write

Matches on email within your organization: an existing contact is updated, otherwise one is created.

Requestcurl -X POST https://api.transmit.dev/v1/contacts \
  -H "Authorization: Bearer tr_v2_…" \
  -H "Content-Type: application/json" \
  -d '{
       "email": "hello@yourdomain.com"
     }'

Body

Field	Type	Notes
`email` required	`string`	email
`first_name`	`string or null`
`last_name`	`string or null`
`phone`	`string or null`
`subscribed`	`boolean`
`tags`	`string[]`	at most 100
`custom_fields`	`object`

Responses

Status	Meaning
`200`	The stored contact
`401`	The API key is missing, malformed, expired or revoked
`403`	The API key lacks the `contact:write` scope
`422`	The request failed validation

Every response body is described in the OpenAPI spec, which this page is generated from.