# contact.created (/webhooks/events/contact-created)

Fires when a new contact is created in your workspace. Combined with [`contact.updated`](/webhooks/events/contact-updated) and [`contact.deleted`](/webhooks/events/contact-deleted), this lets you keep an external system (like a CRM) in sync with SparrowDesk contacts.

For the envelope fields, see [The webhook request](/webhooks#the-webhook-request).

## Example payload

```json
{
  "id": "evt_019f41a0e08b77a0874d6719003600b0",
  "eventType": "contact.created",
  "timestamp": "2026-07-08T12:08:10.203Z",
  "accountId": "1001",
  "payload": {
    "contact": {
      "id": 4296206,
      "first_name": "Jordan",
      "last_name": "",
      "full_name": "Jordan",
      "email": "jordan@example.com",
      "phone": "+1 555 0100",
      "language": null,
      "time_zone": null,
      "country": null,
      "region": null,
      "city": null,
      "active": true,
      "unsubscribed": false,
      "blocked": false,
      "avatar": null,
      "company_id": null,
      "company_name": null,
      "custom_fields": {},
      "properties": {
        "initial_avatar_color": {
          "backgroundColor": "linear-gradient(0deg, rgba(255, 255, 255, 0.75) 0%, rgba(255, 255, 255, 0.75) 100%)",
          "textColor": "linear-gradient(180deg, #C083D8 0%, #9830C2 100%)"
        }
      },
      "created_at": 1783512490,
      "updated_at": 1783512490
    }
  },
  "webhookMetadata": {
    "webhookTargetId": "37",
    "deliveryAttemptId": "019f41a0e0db706098cca0aaabd83d2e",
    "deliveryAttemptNumber": 1
  }
}
```

## The contact object

| Field           | Type           | Description                                                   |
| --------------- | -------------- | ------------------------------------------------------------- |
| `id`            | number         | Contact ID.                                                   |
| `first_name`    | string         | First name.                                                   |
| `last_name`     | string         | Last name.                                                    |
| `full_name`     | string         | Full display name.                                            |
| `email`         | string \| null | Email address.                                                |
| `phone`         | string \| null | Phone number.                                                 |
| `language`      | string \| null | Preferred language.                                           |
| `time_zone`     | string \| null | Time zone.                                                    |
| `country`       | string \| null | Country.                                                      |
| `region`        | string \| null | Region or state.                                              |
| `city`          | string \| null | City.                                                         |
| `active`        | boolean        | Whether the contact is active.                                |
| `unsubscribed`  | boolean        | Whether the contact has unsubscribed from emails.             |
| `blocked`       | boolean        | Whether the contact is blocked.                               |
| `avatar`        | string \| null | Avatar image URL, if set.                                     |
| `company_id`    | number \| null | ID of the company the contact belongs to, or `null`.          |
| `company_name`  | string \| null | Name of the company, or `null`.                               |
| `custom_fields` | object         | Custom field values set on the contact.                       |
| `properties`    | object         | System-managed metadata (for example, avatar display colors). |
| `created_at`    | number         | When the contact was created (Unix timestamp, seconds).       |
| `updated_at`    | number         | When the contact was last updated (Unix timestamp, seconds).  |

## Related events

* [`contact.updated`](/webhooks/events/contact-updated) — a contact's fields change
* [`contact.deleted`](/webhooks/events/contact-deleted) — a contact is deleted