Skip To Content
Tessel

GuidesConnect

Shifts API

Read and change shifts from your own code, and hear when one is picked up.

5 minute read

The API reads and changes shifts, and sends a webhook when one is picked up. Keys are made per site under Settings, and can be read only.

List shifts

Terminal
curl "https://api.tessel.example/v1/shifts?site=harbour-street&week=2026-05-11" \  -H "Authorization: Bearer $TESSEL_KEY"

Each shift in the response looks like this:

JSON
{  "id": "shf_8a2k",  "date": "2026-05-16",  "start": "08:00",  "end": "16:00",  "role": "Barista",  "person": "Priya Shah",  "status": "picked_up",  "picked_up_at": "2026-05-15T21:32:00Z"}

Open a shift

Send a shift with no person and Tessel offers it the same way it offers a dropped one.

Terminal
curl https://api.tessel.example/v1/shifts \  -H "Authorization: Bearer $TESSEL_KEY" \  -d site=harbour-street \  -d date=2026-05-16 -d start=08:00 -d end=16:00 -d role=Barista

The shift.picked_up webhook

When someone takes an open shift, Tessel posts the shift to your webhook address, signed with your key, within a second.