# Bulk

## Delete

**delete** `/api/v2/contacts`

Delete multiple contacts by their IDs

### Body Parameters

- `contact_ids: array of string`

  Array of phone numbers in E.164 format to delete

### Returns

- `amount: optional number`

  Number of contacts deleted

- `status: optional string`

### Example

```http
curl https://api.sendblue.co/api/v2/contacts \
    -X DELETE \
    -H "sb-api-key-id: $SENDBLUE_API_API_KEY" \
    -H "sb-api-secret-key: $SENDBLUE_API_API_SECRET"
```

## Create

**post** `/api/v2/contacts/bulk`

Create multiple contacts in bulk

### Body Parameters

- `contacts: array of object { phone, company_name, custom_variables, 3 more }`

  - `phone: string`

    Phone number in E.164 format

  - `company_name: optional string`

    Company name

  - `custom_variables: optional map[string]`

    Custom key-value pairs. Keys are human-readable labels; new labels are auto-created.

  - `first_name: optional string`

    Contact's first name

  - `last_name: optional string`

    Contact's last name

  - `tags: optional array of string`

### Returns

- `contacts: optional array of Contact`

  - `assigned_to_email: optional string`

    Email of assigned user

  - `company_name: optional string`

    Company name

  - `created_at: optional string`

    When the contact was created

  - `custom_variables: optional map[string]`

    Custom key-value pairs stored on the contact. Keys are human-readable labels.

  - `first_name: optional string`

    First name

  - `last_name: optional string`

    Last name

  - `phone: optional string`

    Phone number in E.164 format

  - `sendblue_number: 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`

### Example

```http
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"
            }
          ]
        }'
```