Create bulk of contacts

Create bulk of contacts (max 1000).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
⚠️
Payload size limitation

Payload size is limited to 1MB. Sending 1000 contacts with too many fields (and custom fields) will result in the http call being rejected (HTTP 413 Entity too large)

Error cases

Partially OK call (207)

See failure cases for “Create a contact” ⇒ most will result in a 207 here

{
    "time": 59,
    "errors": 1,
    "status": null,
    "items": [
        {
            "contact_id": "[email protected]",
            "code": 400,
            "description": "double optin option should have some lists to prepare"
        },
        {
            "contact_id": "[email protected]",
            "code": 201,
            "description": ""
        }
    ]
}

Malformatted email (400)

{
    "status": 400,
    "errors": [
        {
            "error_key": "contacts[1].email",
            "error": "wrong_email",
            "error_description": "The email given should have the right format"
        }
    ]
}

Custom field wrong type (400)

{
    "status": 400,
    "errors": [
        {
            "error_key": "contacts[1].custom_fields[0].value",
            "error": "wrong_type",
            "error_description": "This value should be of type string."
        }
    ]
}

Email not specified (503)

{
    "status": 503,
    "errors": {
        "error_key": null,
        "error": "internal_error",
        "error_description": "An error happened."
    }
}
Body Params

Contacts data.

contacts
array of objects
contacts
Responses

401

Authentication failed.

403

Forbidden.

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json