mndrAPI Docs
Contacts

Batch Upsert

Upsert up to 100 contacts in a single request.

POST /api/v1/contacts/batch

Batch upsert up to 100 contacts. Each contact is upserted by email using the same merge logic as the single upsert.

Parameters

ParameterTypeRequiredDescription
contactsarrayYesArray of contact objects (max 100). Same fields as create.

Example

Request
curl -X POST /api/v1/contacts/batch \
  -H "x-api-key: mndr_..." \
  -H "Content-Type: application/json" \
  -d '{
  "contacts": [
    { "email": "alice@example.com", "firstName": "Alice" },
    { "email": "bob@example.com", "firstName": "Bob" }
  ]
}'
Response (201)
{
  "summary": {
    "total": 2,
    "inserted": 1,
    "updated": 1
  }
}

On this page