SEOMadman
SEOMadman docsStart free

Developer

Webhooks

Receive signed events for syncs, winners, and alerts, verified by signature.

What they are

Webhooks push signed events to your endpoint when something happens - a sync completes, a winner is detected, an alert fires.

Verifying

Every delivery is signed. Verify the signature before trusting the payload:

POST /your-endpoint
X-SEOMadman-Signature: t=...,v1=...

Reject any request whose computed signature does not match. Never act on an unverified payload.

Delivery

Deliveries retry on failure with backoff. Endpoints should be idempotent.