Agency Partners
Add a Client
Adds a client workspace under your agency, optionally with the client's own login.
https://app.tryredrover.com/api/public/v1/clientsclients:writeNeeds a partner key; any other key or a connected AI app gets 403.
contact is who you deal with at the client, kept for your records. Storing it sends no invite.
With contactEmail, that person gets a client login to this workspace only: they can use it but never see billing or your other clients. No email is sent; you tell them how to sign in. It also becomes the contact's email when contact.email is not given.
Your listeners get client.created. A sandbox key records a sandbox client instead, and nothing is created.
Headers
AuthorizationstringRequiredBearerfollowed by anrr_live_API key or a connected app's access token. See Authentication.
Body
namestringRequiredThe client's name, up to 200 characters
1 to 200 characters
referencestringYour own ID for the client. Unique within your agency
1 to 200 characters
contactEmailstringAdds this person as the client's own login
up to 320 characters
contactobjectYour contact at the client:
nameandemail, both optional. No invite is sentShow 2 Child FieldsHide Child Fields
namestringup to 120 characters · nullable
emailany or string or string
Response
201 The new client.
dataobjectRequiredShow 7 Child FieldsHide Child Fields
idstringRequiredThe client's workspace ID (UUID)
namestringRequiredThe client's name
referencestringRequiredYour own ID for the client, like a CRM record
nullable
contactobjectRequiredWho you deal with at the client, for your records. Storing a contact sends no invite
Show 2 Child FieldsHide Child Fields
namestringRequiredYour contact's name
nullable
emailstringRequiredYour contact's email
nullable
sandboxbooleanRequiredTrue for clients made with a sandbox key
createdAtstringRequiredISO 8601 datetime
invitedContactEmailstringRequiredThe client login added with the client, when you sent one
nullable
Errors
Every error uses the error envelope.
400name is missing or a field is invalid409Another client already uses this name or reference401The Authorization header is missing, or the key is invalid or revoked403The key lacks the endpoint's scope, or cannot reach the workspace429More than 120 requests in a minute. Wait for Retry-After seconds500Something went wrong on our side
curl -X POST "https://app.tryredrover.com/api/public/v1/clients" \
-H "Authorization: Bearer $REDROVER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Acme Analytics",
"reference": "crm-1042",
"contact": {
"name": "Jane Smith",
"email": "jane@acme.com"
}
}'{
"data": {
"id": "8f14e45f-ceea-4e1a-9c2b-6d7a1c3b9e21",
"name": "Acme Analytics",
"reference": "crm-1042",
"contact": {
"name": "Jane Smith",
"email": "jane@acme.com"
},
"sandbox": false,
"createdAt": "2026-11-16T10:00:00Z",
"invitedContactEmail": null
}
}