## Create

`contacts.create(ContactCreateParams**kwargs)  -> ContactCreateResponse`

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

Create a new contact or update existing if update_if_exists is true

### Parameters

- `number: str`

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

- `assigned_to_email: Optional[str]`

  Email of assigned user (preferred)

- `assigned_to_email: Optional[str]`

  Email of assigned user (deprecated, use assigned_to_email)

- `custom_variables: Optional[Dict[str, str]]`

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

- `first_name: Optional[str]`

  Contact's first name (preferred)

- `first_name: Optional[str]`

  Contact's first name (deprecated, use first_name)

- `last_name: Optional[str]`

  Contact's last name (preferred)

- `last_name: Optional[str]`

  Contact's last name (deprecated, use last_name)

- `phone_number: Optional[str]`

  Contact's phone number (deprecated, use number)

- `phone_number: Optional[str]`

  Contact's phone number (deprecated, use number)

- `sendblue_number: Optional[str]`

  Associated Sendblue phone number to send with (preferred)

- `sendblue_number: Optional[str]`

  Associated Sendblue phone number (deprecated, use sendblue_number)

- `tags: Optional[SequenceNotStr[str]]`

  Tags for the contact

- `update_if_exists: Optional[bool]`

  If true, updates the contact if it already exists

### Returns

- `class ContactCreateResponse: …`

  - `contact: Optional[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

    - `custom_variables: Optional[Dict[str, str]]`

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

    - `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]`

### Example

```python
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
)
contact = client.contacts.create(
    number="number",
)
print(contact.contact)
```