WATCH COMPANIES / API REFERENCE

Set the callback URL

Configure the destination that receives company-change notifications.

PUT/companies/watch/callbackOfficial reference

Parameters

callbackbody · URLRequired

Your HTTPS webhook receiver.

Working with this response

This operation sets the callback without a company ID. Treat it as shared configuration; check the current URL before replacing it.
Confirm webhook authentication/signing, retry behavior and delivery guarantees with the provider. They are not specified in this reference.

Response

200 · no body documented

The reference documents HTTP 200, without a JSON response body.

Request example

curl --fail-with-body --request PUT 'https://api.globaldatabase.com/v2/companies/watch/callback' \
  --header "Authorization: Token $GDB_API_KEY" \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "callback": "https://your-app.example/webhooks/company-changes"
}'

Set GDB_API_KEY in your server environment. These examples are not executed by this page.