Update an agent

Updates one or more fields for an existing agent. Only include the fields you wish to change — omitted fields retain their current values.

Important - email and phone must be unique across all agents and clients in your account. A duplicate is rejected with a 409 error.

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

The first name of the agent.

string

The last name of the agent.

string

The mobile phone number of the agent. Must be 11 digits in length.

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

string

The email address of the agent.

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,}))

string

The name of the Brokerage/Office that this agent is registered with.

string

This agent's designation. For example, "Sales Representative"

string

A URL/Path to an avatar/picture of this agent.

boolean
Defaults to true

If false, disables all operations for the agent.

location
object
string
length ≤ 255

The externalId is intended for storing agent identifiers from external systems (such as CRMs) for reference purposes. Maximum 255 characters.

Responses

404

No agent with the supplied agentId exists in your account.

409

The email or phone number is already in use by another agent or client 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