Entylink
Tutorial

Monitor approved UK businesses with webhooks instead of polling

Use Entylink webhooks to turn approved UK businesses into monitored entities, so filings, officer changes, PSC changes, and status changes flow into operational systems without polling.

company monitoring webhook tutorialuk company alerts api tutorialcompanies house webhook alternativebusiness monitoring workflow tutorial
Guide details
Read time
9 min
Estimated for an engineer implementing the flow
Level
Intermediate
Assumes comfort with APIs and backend basics
Intent
Implementation
Real product or compliance workflows
Who this is for

Start from the real implementation problem

Target readers
Platform teams replacing polling jobsCompliance and fraud engineers building monitoring loopsProduct teams with approved business portfolios
01Create webhook subscriptions for approved entities
02Subscribe only to the event types you need
03Push change events into queues or review systems
Prerequisites

Keep the setup explicit

01

An approved company number you want to monitor

02

A public HTTPS endpoint that can receive webhook deliveries

03

A stored signing secret for webhook verification

Step by step
Step 01

Decide which events actually matter operationally

Entylink supports event names such as `filing.new`, `officer.appointed`, `officer.resigned`, `psc.added`, `psc.removed`, and `company.status_changed`. Subscribe only to the ones that should trigger review.

Step 02

Create the webhook after approval

Do not create monitoring before you know the final company number you care about. Monitoring belongs to the approved entity set.

cURLExample
curl https://api.entylink.com/v1/webhooks \
  -X POST \
  -H "Authorization: Bearer $ENTYLINK_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/webhooks/entylink",
    "company_number": "08804411",
    "events": ["filing.new", "company.status_changed", "psc.added"]
  }'
Step 03

Push deliveries into a queue, not directly into business logic

A monitoring event should usually enter a queue or review pipeline first. That keeps your webhook endpoint fast, reliable, and easier to retry safely.

Step 04

Attach monitoring to the same entity model used at onboarding

Keep one canonical company number in your own system. Use that same key to join the initial verification case and later monitoring events.