Create a client

Use this endpoint to create a client. When creating saved searches, messages or favorites a client needs to be specified.

Important - at least one of phone or email must be provided. A request that contains neither is rejected with a 400 error.

Email and phone must be unique across all clients and agents in your account. A duplicate is rejected with a 409 error. Email matching is case-insensitive.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
int32
required

The agentId of the agent that this client is assigned to. Each client must be assigned to an agent. Must be an existing agent in your account, otherwise a 400 error is returned.

string

The first name of this client

string

The last name of this client.

string

The mobile phone number of this client (May be used to deliver text messages). Must be 11 digits in length. Required if email is not provided.

Regex pattern: ^(1)([0-9]{10})$

string

The email address of this client (May be used to send emails). Required if phone is not provided.

Regex pattern: ^(([^<>()[]\.,;:\s@"]+(.[^<>()[]\.,;:\s@"]+)*)|(".+"))@(([[0-9]{1,3}.[0-9]{1,3}.[0-9]{1,3}.[0-9]{1,3}])|(([a-zA-Z-0-9]+.)+[a-zA-Z]{2,}))

boolean
Defaults to true

If false, disables all operations for the client.

preferences
object
tags
array of strings

You may categorize this client using tags. Tags are useful for filtering purposes and building lists of specific clients. For example, if this client is a buyer from Toronto, you may want to create tags for "Buyer" and "Toronto".

tags
string

The externalId is intended for storing client identifiers from external systems (such as CRMs) for reference purposes.

Responses

409

The email or phone number is already in use by another client or agent in your account.

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json