Connect your own tools with the API and webhooks
Create API keys and webhooks so other software can read your schedule and hear about changes.
- 1
Create an API key
Open Account settings from your name at the bottom of the sidebar and choose the Integrations tab (Pro and Enterprise). Choose New key, name it after the app that will use it, and pick what it may do: read, change shifts, or read pay. Copy the key when it’s shown; you won’t see it again. Enterprise companies can make keys for every store at once.
- 2
Call the API
Send requests to /api/v1 on your CrewCrow address with the header Authorization: Bearer <your key>. For example, GET /api/v1/shifts?start=2026-11-01&end=2026-11-07 lists that week’s shifts, with times in your store’s timezone. Long lists come in pages: pass next_cursor back as cursor for the next one.
- 3
Add a webhook
Choose New webhook, enter an https URL on your server and pick events like shift.created or time_entry.created. Copy the signing secret when it’s shown. Use Send test to check your server answers, and Deliveries to see every attempt.
- 4
Check the signature
Each webhook carries a CrewCrow-Signature header like t=1730000000,v1=abc123…. Compute HMAC-SHA256 of the timestamp, a period, and the raw request body, using your signing secret as the key. Accept the request only if your result matches v1 and the timestamp is within five minutes.