contacts

Import Contacts

Create or update up to 500 contacts in one call, matched by external_id.

Returns 200 with a per-row report, not 201: a batch is rarely all one thing, and a status code cannot say "4,997 created, 3 rejected". Each row reports created, updated or failed with a reason, so a client can show the user exactly which lines of their file need fixing.

A field omitted from a row is left as it was; a field sent empty is cleared. That is what makes an external_id,email file safe to import over contacts that already carry phones and attributes.

post/v1/contacts/bulk

Request

  • Base URL: https://api.elaan.io (the document declares no server; this is the origin it was published from)
  • URL: https://api.elaan.io/v1/contacts/bulk
  • Auth: none declared

Headers

authorizationstring nullable

Request body

Example request

{
  "contacts": [
    {
      "external_id": "crm-12345",
      "emails": [
        "a@example.com"
      ],
      "phones": [
        "+15551234567"
      ],
      "attributes": {
        "first_name": "Ada",
        "tier": "gold"
      },
      "language": "es"
    }
  ]
}

Response

Successful Response

createdinteger required
updatedinteger required
failedinteger required

Changes

No recorded changes to this operation across all 1 revision of this API.