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

# Register Webhook

> Register a URL to receive Repixa event notifications

# Register Webhook

Registers a webhook endpoint to receive Repixa events.

## Request

```bash theme={null}
POST https://api.repixa.io/v1/webhooks
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

### Body

```json theme={null}
{
  "url": "https://yourapp.com/webhooks/repixa",
  "events": ["demo.completed", "lead.hot", "meeting.booked"]
}
```

| Field    | Type   | Required | Description                                      |
| -------- | ------ | -------- | ------------------------------------------------ |
| `url`    | string | ✅        | Your HTTPS endpoint that will receive the events |
| `events` | array  | ✅        | List of event types to subscribe to              |

### Available event types

* `demo.completed`
* `demo.abandoned`
* `lead.hot`
* `meeting.booked`
* `contact.created`

## Response `201`

```json theme={null}
{
  "id": "wh_01hx...",
  "url": "https://yourapp.com/webhooks/repixa",
  "events": ["demo.completed", "lead.hot", "meeting.booked"],
  "secret": "whsec_xxxxxxxxxxxxxx",
  "created_at": "2026-05-20T10:00:00Z"
}
```

<Warning>
  The `secret` field is only returned once on creation. Store it securely — you'll use it to [verify webhook signatures](/api-reference/endpoint/webhook).
</Warning>