[Cotlet](https://cotlet.dev/index.md) · [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Use cases](https://cotlet.dev/use-cases.md) · [Security](https://cotlet.dev/security.md) · [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) · [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [Contact](https://cotlet.dev/contact.md) · [Pricing](https://cotlet.dev/pricing.md) · [Sign up](https://cotlet.dev/signup)

# Create contact

> Create a new contact in Aircall. Inputs, cURL, Python and Node.js examples and an example response.

Source: https://cotlet.dev/docs/api/aircall/create_contact

Docs sections: [Get started](https://cotlet.dev/docs.md) · [REST API](https://cotlet.dev/docs/api.md) · [MCP](https://cotlet.dev/docs/mcp.md) · [SDKs & CLI](https://cotlet.dev/docs/sdks.md) · [Integrations](https://cotlet.dev/docs/integrations.md)

Create a new contact in Aircall.

Aircall API: https://cotlet.dev/docs/api/aircall.md

`POST https://cotlet.dev/api/v1/aircall/contacts`

Access: write. Confirm: waits for the user's OK before it runs.

Creates a contact as Contacts > Add > Create new contact does. Aircall checks for a contact with the same name or phone number; on a match the tool creates nothing and returns the existing contact. Emojis are removed on save, a contact holds up to 20 extra phone numbers and emails, and notes take up to 30,000 characters. Deleting a contact is an admin action in Aircall, so a wrong one is not undone by a second call. By default you confirm each call; you can switch that off for this tool.

## Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `phone` | string | yes | Phone number in international format. |
| `first_name` | string | no | First name. |
| `last_name` | string | no | Last name. |
| `company` | string | no | Company name. |
| `email` | string | no | Email address. |
| `notes` | string | no | Notes, up to 30,000 characters. |

## Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/aircall/contacts \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone":"+14155550142","first_name":"Priya","last_name":"Raman","company":"Raman Dental","email":"priya@example.com"}'
```

**Python**

```python
result = client.call("aircall", "create_contact", {"phone":"+14155550142","first_name":"Priya","last_name":"Raman","company":"Raman Dental","email":"priya@example.com"})
```

**Node.js**

```js
const result = await cotlet.call('aircall', 'create_contact', {"phone":"+14155550142","first_name":"Priya","last_name":"Raman","company":"Raman Dental","email":"priya@example.com"});
```

**CLI**

```bash
cotlet call aircall create_contact --data '{"phone":"+14155550142","first_name":"Priya","last_name":"Raman","company":"Raman Dental","email":"priya@example.com"}'
```

## Example response

```json
{
  "contact_id": "ct_90118",
  "created": true,
  "name": "Priya Raman",
  "company": "Raman Dental",
  "phones": [
    "+14155550142"
  ],
  "emails": [
    "priya@example.com"
  ]
}
```

Previous: [Send SMS](https://cotlet.dev/docs/api/aircall/send_message.md)

---

Give your AI agents your signed-in browser.

**Product:** [Integrations](https://cotlet.dev/integrations.md) · [Use cases](https://cotlet.dev/use-cases.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Pricing](https://cotlet.dev/pricing.md) · [Security](https://cotlet.dev/security.md)

**Resources:** [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [GitHub](https://github.com/cotletdev/cotlet)

**Solutions:** [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md)

**Company:** [About](https://cotlet.dev/about.md) · [AI info: company facts](https://cotlet.dev/ai-info.md) · [Contact](https://cotlet.dev/contact.md)

**Legal:** [Terms of service](https://cotlet.dev/terms) · [Privacy policy](https://cotlet.dev/privacy) · [Refund policy](https://cotlet.dev/refunds) · [Acceptable use](https://cotlet.dev/acceptable-use) · [Cookie policy](https://cotlet.dev/cookies) · [DPA](https://cotlet.dev/dpa) · [Subprocessors](https://cotlet.dev/subprocessors)

**Elsewhere:** [Status page](https://status.cotlet.dev) · [Cotlet on GitHub](https://github.com/cotletdev) · [Cotlet on X](https://x.com/cotletdev) · [Cotlet on LinkedIn](https://www.linkedin.com/company/cotletdev) · [Cotlet on Product Hunt](https://www.producthunt.com/products/cotlet) · [Cotlet on Crunchbase](https://www.crunchbase.com/organization/cotlet) · [Cotlet on SaaSHub](https://www.saashub.com/cotlet)

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. [About us](https://cotlet.dev/about.md)

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.