Bulk import contacts
const url = 'https://api.caller9.app/v1/organizations/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/contacts/import';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"rows":[{"number":"example","name":"example","location":"example","notes":"example","tags":"example"}],"skipDuplicates":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/import \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "rows": [ { "number": "example", "name": "example", "location": "example", "notes": "example", "tags": "example" } ], "skipDuplicates": true }'Imports up to 5000 contacts in one request. The body is JSON (parse CSV or spreadsheet files client-side into rows). Rows without a usable number are skipped, as are duplicates when skipDuplicates is true.
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
object
Phone number, normalized to E.164 where possible.
Full name; split into first name and the rest as last name.
Comma-separated tags, e.g. vip, regular.
Skip rows whose number already exists in the organization or appears earlier in the same import.
Responses
Section titled “Responses”Import result.
object
Number of contacts created.
Number of rows skipped (invalid or duplicate).
Example generated
{ "imported": 1, "skipped": 1}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.