contact.created
Fires when a new contact is created in SparrowDesk
Fires when a new contact is created in your workspace. Combined with contact.updated and 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.
Example payload
{
"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": "[email protected]",
"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— a contact's fields changecontact.deleted— a contact is deleted