Sign in

v53

latestOpenAPI 3.1.1raw.githubusercontent.com2026-07-264065213.4 KB
Contacts

Create a contact

Creates a new Contact object.

post/accounts/{account_id}/contacts

Path parameters

account_idstring required

The account for which the contact should be created.

Example:acct_01j9a43avnfqzbjfch6pygv1td

Request body

emailstring email

The contact's email address.

first_namestring

The contact's first name.

last_namestring

The contact's last name.

metadataMetadata

Set of key-value pairs that will be stored with the object.

phone_numberstring phone-number required

The contact's phone number in E.164 format.

Example request

{
  "email": "dom@toretto.family",
  "first_name": "Dominic",
  "last_name": "Toretto",
  "metadata": {
    "car": "1970 Dodge Charger R/T"
  },
  "phone_number": "+18015551234"
}

Response

Created contact

emailstring email

The contact's email address.

first_namestring

The contact's first name.

idstring required

Unique identifier for the object.

last_namestring

The contact's last name.

metadataMetadata

Set of key-value pairs that will be stored with the object.

phone_numberstring phone-number required

The contact's phone number in E.164 format.

Example response

{
  "email": "dom@toretto.family",
  "first_name": "Dominic",
  "id": "ctc_01j9dy8mdzfn3r0e8x1tbdrdrf",
  "last_name": "Toretto",
  "metadata": {
    "car": "1970 Dodge Charger R/T"
  },
  "phone_number": "+18015551234"
}