> ## Documentation Index
> Fetch the complete documentation index at: https://help.hoopai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Contact Created | Webhook Events

> Fires whenever a new contact is created in your HoopAI account.

The `ContactCreate` event fires each time a new contact record is created in your account, whether through a form submission, manual entry, API call, or integration import. Use this event to sync new contacts to external CRMs, trigger onboarding workflows, or send a welcome message.

## Payload

| Field          | Type      | Description                                                     |
| -------------- | --------- | --------------------------------------------------------------- |
| `type`         | `string`  | Always `"ContactCreate"`                                        |
| `locationId`   | `string`  | Account ID where the contact was created                        |
| `id`           | `string`  | Unique identifier of the newly created contact                  |
| `firstName`    | `string`  | Contact's first name                                            |
| `lastName`     | `string`  | Contact's last name                                             |
| `name`         | `string`  | Contact's full name                                             |
| `email`        | `string`  | Contact's email address                                         |
| `phone`        | `string`  | Contact's phone number in E.164 format                          |
| `address1`     | `string`  | Street address line 1                                           |
| `city`         | `string`  | City                                                            |
| `state`        | `string`  | State or province                                               |
| `postalCode`   | `string`  | Postal or ZIP code                                              |
| `country`      | `string`  | Country code (e.g., `"US"`, `"DE"`)                             |
| `companyName`  | `string`  | Name of the contact's company                                   |
| `website`      | `string`  | Contact's website URL                                           |
| `source`       | `string`  | How the contact was created (e.g., form name, integration name) |
| `dateAdded`    | `string`  | ISO 8601 timestamp of when the contact was created              |
| `dateOfBirth`  | `string`  | Contact's date of birth in ISO 8601 format                      |
| `dnd`          | `boolean` | Whether the contact has Do Not Disturb enabled globally         |
| `tags`         | `array`   | List of tag strings applied to the contact                      |
| `attachments`  | `array`   | List of file attachments associated with the contact            |
| `assignedTo`   | `string`  | User ID of the team member assigned to this contact             |
| `customFields` | `array`   | Array of custom field values with `id` and `value` properties   |

## Example payload

```json theme={null}
{
  "type": "ContactCreate",
  "locationId": "ve9EPM428h8vShlRW1KT",
  "id": "nmFmQEsNgz6AVpgLVUJ0",
  "address1": "3535 1st St N",
  "city": "ruDolomitebika",
  "state": "AL",
  "companyName": "Loram ipsum",
  "country": "DE",
  "source": "xyz form",
  "dateAdded": "2021-11-26T12:41:02.193Z",
  "dateOfBirth": "2000-01-05T00:00:00.000Z",
  "dnd": true,
  "email": "JohnDeo@gmail.com",
  "name": "John Deo",
  "firstName": "John",
  "lastName": "Deo",
  "phone": "+919509597501",
  "postalCode": "452001",
  "tags": ["id magna sed Lorem", "Duis dolor commodo aliqua"],
  "website": "https://www.google.com/",
  "attachments": [],
  "assignedTo": "nmFmQEsNgz6AVpgLVUJ0",
  "customFields": [
    {
      "id": "BcdmQEsNgz6AVpgLVUJ0",
      "value": "XYZ Corp"
    }
  ]
}
```

## Related

* [Contact Updated](/api-reference/webhooks/contact-update) — fires when an existing contact's fields change
* [Contact Deleted](/api-reference/webhooks/contact-delete) — fires when a contact is permanently removed
* [Contacts API](/api-reference/contacts/overview) — query and update contacts programmatically