Skip to main content
POST
Find contacts

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

Search criteria

Search criteria

developerProvider
enum<string>
required

Integration provider making the request

Available options:
zapier
id
string
required

Workspace ID the request targets

Maximum string length: 45
searchText
string

Free-text search term

Maximum string length: 255
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