## Create

`client.contacts.create(ContactCreateParamsbody, RequestOptionsoptions?): ContactCreateResponse`

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

Create a new contact or update existing if update_if_exists is true

### Parameters

- `body: ContactCreateParams`

  - `number: string`

    Contact's phone number in E.164 format (preferred)

  - `assigned_to_email?: string`

    Email of assigned user (preferred)

  - `assignedToEmail?: string`

    Email of assigned user (deprecated, use assigned_to_email)

  - `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 (preferred)

  - `firstName?: string`

    Contact's first name (deprecated, use first_name)

  - `last_name?: string`

    Contact's last name (preferred)

  - `lastName?: string`

    Contact's last name (deprecated, use last_name)

  - `phone_number?: string`

    Contact's phone number (deprecated, use number)

  - `phoneNumber?: string`

    Contact's phone number (deprecated, use number)

  - `sendblue_number?: string`

    Associated Sendblue phone number to send with (preferred)

  - `sendblueNumber?: string`

    Associated Sendblue phone number (deprecated, use sendblue_number)

  - `tags?: Array<string>`

    Tags for the contact

  - `update_if_exists?: boolean`

    If true, updates the contact if it already exists

### Returns

- `ContactCreateResponse`

  - `contact?: 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 contact = await client.contacts.create({ number: 'number' });

console.log(contact.contact);
```