Create

API Reference

Contacts

Bulk

Create multiple contacts

post/api/v2/contacts/bulk

Create multiple contacts in bulk

Body ParametersExpand Collapse

contacts: array of object { phone, company, firstName, 2 more }

phone: string

company: optional string

firstName: optional string

lastName: optional string

tags: optional array of string

ReturnsExpand Collapse

contacts: optional array of Contact { assignedToEmail, companyName, created_at, 6 more }

assignedToEmail: optional string

Email of assigned user

companyName: optional string

Company name

created_at: optional string

When the contact was created

formatdate-time

firstName: optional string

First name

lastName: optional string

Last name

phone: optional string

Phone number in E.164 format

sendblueNumber: optional string

Associated Sendblue phone number

tags: optional array of string

Tags associated with the contact

verified: optional boolean

Whether the contact is verified

status: optional string

Create multiple contacts

http

• http
• typescript
• python

curl https://api.sendblue.co/api/v2/contacts/bulk \
    -H 'Content-Type: application/json' \
    -H "sb-api-key-id: $SENDBLUE_API_API_KEY" \
    -H "sb-api-secret-key: $SENDBLUE_API_API_SECRET" \
    -d '{
          "contacts": [
            {
              "phone": "phone"
            }
          ]
        }'

200 example

{
  "contacts": [
    {
      "assignedToEmail": "[email protected]",
      "companyName": "Example Corp",
      "created_at": "2024-01-15T10:30:00Z",
      "firstName": "John",
      "lastName": "Doe",
      "phone": "+1234567890",
      "sendblueNumber": "+1987654321",
      "tags": [
        "customer",
        "vip"
      ],
      "verified": true
    }
  ],
  "status": "OK"
}

Returns Examples

200 example

{
  "contacts": [
    {
      "assignedToEmail": "[email protected]",
      "companyName": "Example Corp",
      "created_at": "2024-01-15T10:30:00Z",
      "firstName": "John",
      "lastName": "Doe",
      "phone": "+1234567890",
      "sendblueNumber": "+1987654321",
      "tags": [
        "customer",
        "vip"
      ],
      "verified": true
    }
  ],
  "status": "OK"
}