Skip to main content
POST
Create or update a contact

Authorizations

Authorization
string
header
required

An OAuth 2.0 access token, sent as Authorization: Bearer <token>. MessageDesk is the OAuth 2.0 provider (backed by AWS Cognito): an integration such as Zapier obtains the token through the authorization-code flow when a user connects their MessageDesk account. Access tokens are valid for 24 hours and are refreshed with the refresh token.

Body

application/json

Contact to create or update

Contact to create or update

developerProvider
enum<string>
required

Integration provider making the request

Available options:
zapier
id
string
required

Workspace ID the request targets

Maximum string length: 45
phone
string
required

Contact phone number in E.164 format

email
string

Contact email address

firstName
string

Contact first name

Maximum string length: 255
lastName
string

Contact last name

Maximum string length: 255
properties
object

Custom contact property values keyed by property name

userId
string

Optional acting user; overwritten with the authenticated user on endpoints that record authorship

Maximum string length: 45

Response

OK

email
string
firstName
string
id
string
lastName
string
phone
string
properties
object
workspaceId
string