# Bulk

## Delete

`client.contacts.bulk.delete(BulkDeleteParamsbody, RequestOptionsoptions?): BulkDeleteResponse`

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

Delete multiple contacts by their IDs

### Parameters

- `body: BulkDeleteParams`

  - `contact_ids: Array<string>`

    Array of phone numbers in E.164 format to delete

### Returns

- `BulkDeleteResponse`

  - `amount?: number`

    Number of contacts deleted

  - `status?: string`

### Example

```typescript
import SendblueAPI from 'sendblue';

const client = new SendblueAPI({
  apiKey: process.env['SENDBLUE_API_API_KEY'], // This is the default and can be omitted
  apiSecret: process.env['SENDBLUE_API_API_SECRET'], // This is the default and can be omitted
});

const bulk = await client.contacts.bulk.delete({ contact_ids: ['+1234567890', '+0987654321'] });

console.log(bulk.amount);
```

## Create

`client.contacts.bulk.create(BulkCreateParamsbody, RequestOptionsoptions?): BulkCreateResponse`

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

Create multiple contacts in bulk

### Parameters

- `body: BulkCreateParams`

  - `contacts: Array<Contact>`

    - `phone: string`

      Phone number in E.164 format

    - `company_name?: string`

      Company name

    - `custom_variables?: Record<string, string>`

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

    - `first_name?: string`

      Contact's first name

    - `last_name?: string`

      Contact's last name

    - `tags?: Array<string>`

### Returns

- `BulkCreateResponse`

  - `contacts?: Array<Contact>`

    - `assigned_to_email?: string`

      Email of assigned user

    - `company_name?: string`

      Company name

    - `created_at?: string`

      When the contact was created

    - `custom_variables?: Record<string, string>`

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

    - `first_name?: string`

      First name

    - `last_name?: string`

      Last name

    - `phone?: string`

      Phone number in E.164 format

    - `sendblue_number?: string`

      Associated Sendblue phone number

    - `tags?: Array<string>`

      Tags associated with the contact

    - `verified?: boolean`

      Whether the contact is verified

  - `status?: string`

### Example

```typescript
import SendblueAPI from 'sendblue';

const client = new SendblueAPI({
  apiKey: process.env['SENDBLUE_API_API_KEY'], // This is the default and can be omitted
  apiSecret: process.env['SENDBLUE_API_API_SECRET'], // This is the default and can be omitted
});

const bulk = await client.contacts.bulk.create({ contacts: [{ phone: 'phone' }] });

console.log(bulk.contacts);
```