Before you beginYou need the cluck CLI, a Pollosoft account, and a coop to work in. No prior experience required. Curiosity and a mild fondness for chickens are helpful.
Overview
Receive events from Pollosoft and verify they are real. The whole thing takes about 9 minutes, and the commands below are the ones you will use along the way.
$ cluck webhook create --url https://example.com/hook
$ cluck webhook test
$ cluck webhook logsSteps
- Create an endpoint. Provide an HTTPS URL that accepts POST. Pollosoft sends events as JSON with a signature header.
- Verify signatures. Compute an HMAC of the body with your signing secret and compare it to the header. Reject anything that does not match.
- Respond fast. Return a 2xx within five seconds. Do real work in a queue. Pollosoft retries failed deliveries with exponential backoff.
- Replay events. Use the dashboard or cluck webhook replay to resend events if your endpoint was down overnight.
Commands used
Keep going
- Molt: safe schema migrations (13 min)
- Your first coop: workspaces explained (10 min)
- Backups and the Frozen Chicken Archive (10 min)
Stuck? Check the error codes, the FAQ, or the glossary.