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

# Add Webhook

> Register the URL that Finrock sends deposit, withdrawal and status-change events to.

**[MCP scope](https://apidocs.finrock.io/api-reference/mcp-scopes.md):** `dac.write`

Use this endpoint to register the URL that receives webhook events for your sub-account. Each account has one webhook URL. If your account already has one, the request is refused. To change the URL, first remove the current one with [Delete Webhook](https://apidocs.finrock.io/api-reference/webhooks/delete-webhook.md), then add the new one. Your endpoint must return HTTP `200` to acknowledge each event, and should verify the `x-signature` header. See the [Webhooks guide](https://apidocs.finrock.io/guides/webhooks.md).

## Body Parameters

**url** `string` *required*

The HTTPS URL that receives webhook events, for example `https://example.com/api/webhook`.

```bash cURL theme={null}
curl --request POST \
     --url https://api.finrock.io/dac/v1/webhook \
     --header 'Authorization: Bearer {JWT}' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-api-key: YOUR_API_KEY' \
     --data '{
       "url": "https://example.com/api/webhook"
     }'
```

## Response

A successful request returns HTTP `200` with the registered webhook.

**url** `string`

The URL you registered.

**added\_on** `string`

When the URL was added, as an ISO 8601 timestamp in UTC.

```json 200 theme={null}
{
  "url": "https://example.com/api/webhook",
  "added_on": "2026-10-30T10:23:20.4054201Z"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.