Skip to main content

Batch create contacts

POST/contacts/batch/new

Create multiple contacts in a single request. The request body is an array of contact objects. Maximum 200 contacts per request.

Inserting custom objects and a child item (premium)​

Add a customObjects block to any contact to create and link custom object items — and a child item via linkedCustomObjects — in the same request. Requires a premium plan; on other plans the block is silently ignored (the contact is still created and the response is 201, with no error). Identify each object by alias or id, and put field values under attributes. Call with ?includeCustomObjects=true to return the created items in the response. Replace the aliases (product, order-line) and the attributes keys with your own.

[
  {
    "email": "jane@example.com",
    "firstname": "Jane",
    "customObjects": {
      "data": [
        {
          "alias": "product",
          "data": [
            {
              "name": "Contract A",
              "attributes": { "reference": "ABC-123" },
              "linkedCustomObjects": [
                {
                  "alias": "order-line",
                  "data": [
                    { "name": "Line 1", "attributes": { "sku": "SKU-001", "quantity": 2 } }
                  ]
                }
              ]
            }
          ]
        }
      ]
    }
  }
]

Request​

Responses​

Contacts created