Create multiple contacts

contacts.bulk.create() -> BulkCreateResponse

post/api/v2/contacts/bulk

Create multiple contacts in bulk

ParametersExpand Collapse

contacts: Iterable[Contact]

phone: str

Phone number in E.164 format

company_name: Optional[str]

Company name

first_name: Optional[str]

Contact's first name

last_name: Optional[str]

Contact's last name

tags: Optional[SequenceNotStr[str]]

ReturnsExpand Collapse

class BulkCreateResponse: …

contacts: Optional[List[Contact]]

assigned_to_email: Optional[str]

Email of assigned user

company_name: Optional[str]

Company name

created_at: Optional[datetime]

When the contact was created

formatdate-time

first_name: Optional[str]

First name

last_name: Optional[str]

Last name

phone: Optional[str]

Phone number in E.164 format

sendblue_number: Optional[str]

Associated Sendblue phone number

tags: Optional[List[str]]

Tags associated with the contact

verified: Optional[bool]

Whether the contact is verified

status: Optional[str]

Create multiple contacts

import os
from sendblue_api import SendblueAPI

client = SendblueAPI(
    api_key=os.environ.get("SENDBLUE_API_API_KEY"),  # This is the default and can be omitted
    api_secret=os.environ.get("SENDBLUE_API_API_SECRET"),  # This is the default and can be omitted
)
bulk = client.contacts.bulk.create(
    contacts=[{
        "phone": "phone"
    }],
)
print(bulk.contacts)

{
  "contacts": [
    {
      "assigned_to_email": "[email protected]",
      "company_name": "Example Corp",
      "created_at": "2024-01-15T10:30:00Z",
      "first_name": "John",
      "last_name": "Doe",
      "phone": "+1234567890",
      "sendblue_number": "+1987654321",
      "tags": [
        "customer",
        "vip"
      ],
      "verified": true
    }
  ],
  "status": "OK"
}

Returns Examples

{
  "contacts": [
    {
      "assigned_to_email": "[email protected]",
      "company_name": "Example Corp",
      "created_at": "2024-01-15T10:30:00Z",
      "first_name": "John",
      "last_name": "Doe",
      "phone": "+1234567890",
      "sendblue_number": "+1987654321",
      "tags": [
        "customer",
        "vip"
      ],
      "verified": true
    }
  ],
  "status": "OK"
}