Add Webhook - Finrock

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"
     }'

{
  "url": "https://example.com/api/webhook",
  "added_on": "2026-10-30T10:23:20.4054201Z"
}

POST

dac

webhook

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"
     }'

{
  "url": "https://example.com/api/webhook",
  "added_on": "2026-10-30T10:23:20.4054201Z"
}

MCP scope: 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, 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.

Body Parameters

string

required

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

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.

string

The URL you registered.

string

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

{
  "url": "https://example.com/api/webhook",
  "added_on": "2026-10-30T10:23:20.4054201Z"
}