# Custom webhooks

> Send contacts in from any system that can post JSON.

_Source: https://hexafloww.com/docs/connectors/custom-webhooks_

---

If your source isn't one of the built-in connectors, a custom webhook lets any system that can send an HTTP request add contacts to HexaFloww.

## Set one up

1. **Open Connectors → Custom Webhooks → Add Webhook.** Go to `/admin/connectors/custom-webhooks`.
2. **Name it** and click **Create webhook**. HexaFloww gives you a **unique URL** and a **secret** (the secret is shown only once).
3. **Configure the sending system** to POST JSON to that URL with the secret as an `Authorization: Bearer <secret>` header.
4. **Map fields** on the webhook's detail page — tell HexaFloww which JSON keys are email, name, phone, and so on, and whether to keep unmapped keys as custom fields.

![Custom webhook page with the URL, secret, and field mapping](https://hexafloww.com/docs/connectors/custom-webhook.webp)

## What to send

A JSON object per contact, with the secret in the `Authorization` header:

```
POST <your webhook URL>
Authorization: Bearer <secret>
Content-Type: application/json

{
  "email": "sam@example.com",
  "name": "Sam Lee",
  "phone": "+919876543210",
  "source": "partner-site"
}
```

Each delivery is logged with the result. You can see recent contacts added by this webhook from its detail page.

## Common problems

- **401 / rejected** — the secret is missing or wrong.
- **Contact not created** — no email key, or the email key name doesn't match your field mapping.
- **Nothing in the log** — the request isn't reaching the URL; check it in the sending system.