Create a contact
const url = 'https://api.caller9.app/v1/organizations/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/contacts';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"number":"example","name":"example","first_name":"example","last_name":"example","location":"example","notes":"example","mood":"example","tags":["example"],"favourite":true}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.caller9.app/v1/organizations/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/contacts \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "number": "example", "name": "example", "first_name": "example", "last_name": "example", "location": "example", "notes": "example", "mood": "example", "tags": [ "example" ], "favourite": true }'Adds a contact to the organization’s address book.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Organization ID (UUID). Must be the organization that owns the API key.
Request Bodyrequired
Section titled “Request Bodyrequired”object
Phone number. Normalized to E.164 (US assumed when no country code); stored as given if it can’t be parsed.
Short mood marker (typically an emoji). An empty string clears it.
Example generated
{ "number": "example", "name": "example", "first_name": "example", "last_name": "example", "location": "example", "notes": "example", "mood": "example", "tags": [ "example" ], "favourite": true}Responses
Section titled “Responses”The created contact.
object
object
Phone number, E.164 where parseable.
JSON-encoded array of strings, e.g. ["vip","regular"].
Always null for contacts returned by the API.
Example
{ "contact": { "tags": "[\"vip\",\"regular\"]", "favourite": 0 }}The request was invalid.
object
Human-readable error message.
Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).
Example generated
{ "error": "example", "code": "example"}Missing, invalid, expired or revoked API key.
object
Human-readable error message.
Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).
Example generated
{ "error": "example", "code": "example"}Not found, or belongs to another organization.
object
Human-readable error message.
Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).
Example generated
{ "error": "example", "code": "example"}Too many requests for this API key. Retry after Retry-After seconds.
object
Human-readable error message.
Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).
Example generated
{ "error": "example", "code": "example"}Headers
Section titled “Headers”Seconds until the rate-limit window resets.