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

# Webhooks

> Register HTTPS receivers for async Swapnice events.

Registration is live. Signed delivery of `event.processed`, `event.failed`, `consent.revoked`, and `profile.updated` is near-term. Build the receiver now; until delivery ships, poll event and workflow status.

The signing secret is shown once.

## Endpoints in this group

| Method | Path                                                               | Scope            |
| ------ | ------------------------------------------------------------------ | ---------------- |
| `POST` | [`/v1/webhook-endpoints`](/partners/api-reference/webhooks-create) | `webhooks:write` |
| `GET`  | [`/v1/webhook-endpoints`](/partners/api-reference/webhooks-list)   | `webhooks:read`  |

```json theme={null}
{
  "url": "https://partner.example.com/swapnice/webhooks",
  "enabled_events": ["event.processed", "event.failed", "consent.revoked", "profile.updated"]
}
```

What to do with each type: [webhooks guide](/partners/webhooks).
