← Back to docs
Webhooks
POST/v1/webhooks
Create webhook endpoint
Use the create webhook endpoint to subscribe a company number to filing, officer, PSC, and status-change events and receive a signing secret for verification.
When to use it
Practical implementation contexts
Start monitoring a company after approval
Register outbound deliveries to internal queues or apps
Capture the signing secret shown on creation
Auth
Access model
Authentication
API key or dashboard session
Request
curl https://api.entylink.com/v1/webhooks \
-X POST \
-H "Authorization: Bearer etl_live_••••••••a7f2" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com/webhooks/entylink",
"company_number": "08804411",
"events": ["filing.new", "officer.appointed", "psc.added"]
}'
Parameters
ParameterTypeDescription
urlstringHTTPS destination for webhook deliveries
company_numberstringCompany number to monitor
eventsstring[]One or more supported event names
Response
Response exampleapplication/json
{
"data": {
"id": "wh_abc123",
"company_number": "08804411",
"events": ["filing.new", "officer.appointed", "psc.added"],
"is_active": true,
"secret": "whsec_..."
}
}Related pages
Keep moving from docs into implementation and evaluation
Next step
Move from docs into a real registry workflow.
Entylink is built for teams embedding UK company data, verification, and monitoring into products rather than manually browsing the register.