All tutorials
Managers

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.

5 min read · 4 steps
  1. 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. 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. 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. 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.

Still stuck?

Sign in and open Help from the sidebar to message us. We reply in the app. Can’t sign in? Email [email protected].

Contact support