EspressoIntegration

BasilBook integration

Hook DailyBrew up to BasilBook. Link your staff by username, make an API key, and let BasilBook pull the hours across on its own — check-in times, late flags, shift info, all in one call.

Why this exists

Hours live in DailyBrew. Accounts live in BasilBook. Neither one talks to the other.

Without a link you'd be cross-checking by hand who was in, who came in late, and what shift they worked — then typing it all into your accounts. Slow, easy to get wrong, and nobody wants the job.

The BasilBook link closes the gap. BasilBook pulls the hours straight out of DailyBrew over a secure connection, matching people by username.

How it works

Link your staff by username

Everyone in DailyBrew can carry a username — the same one BasilBook knows them by. When BasilBook pulls the hours, it matches on that.

Make an API key

In your shop settings, make an API key. The full key shows once — copy it and put it into BasilBook. We only keep a fingerprint of it, so the key itself can never be fetched back.

BasilBook asks for the hours

BasilBook sends a GET with the key in the X-Api-Key header and a date range, up to 93 days. DailyBrew sends back the days for everyone who has a username — in and out times, late flags, shift info, all in your shop's timezone.

It keeps itself up to date

Once it's set up, BasilBook can pull on whatever rhythm suits — daily, weekly, or whenever you ask. No exports, no CSV files, no copy-pasting. The numbers are always the current ones.

What comes back

For everyone with a username, you get their days inside the range you asked for:

Username— What links the two systems
Name— Full name, for reading
Shift name— Their shift, or nothing
Date— The day (YYYY-MM-DD)
Check-in time— HH:mm in your shop's timezone
Check-out time— HH:mm, or nothing if they're still in
Came in late— true if they arrived after the shift started
Slipped out early— true if they left before the shift ended

Days with nothing on them are left out — a missing date means nobody came in. Longest range in one call: 93 days.

What you get

Nothing to retype

Hours go from DailyBrew to BasilBook on their own. No spreadsheets, no copy-pasting, no numbers dropped along the way.

Always current

BasilBook reads live from DailyBrew. Daily or weekly, what it gets is the latest check-ins, late flags and shifts.

Safe by design

We keep only a fingerprint of each key — the key itself shows once and is never stored. Revoke one any time. Each key works for one shop and nothing else.

Matched by username

People are linked by username across both systems. No fragile email matching, no mapping by hand. Set it once and the link holds.

Setting it up

Two parts: give your staff usernames, then make an API key for BasilBook.

1

Give everyone a username

Open each person's page and enter the username BasilBook knows them by. It has to match exactly.

2

Make an API key

In shop settings, scroll to "API keys" and make one. Name it something you'll recognise — "BasilBook". The full key shows once, so copy it right away.

3

Set it up in BasilBook

In BasilBook, paste the key into the DailyBrew settings. BasilBook sends it in the X-Api-Key header when it asks for the hours.

4

Try it once

Run a test pull from BasilBook. You should see days for everyone who has a username. Someone missing? Check their username in DailyBrew.

Common questions

What if I lose the API key?

The full key shows once, when you make it. Lost it? Revoke the old one, make a new one, and update BasilBook.

Can I have more than one key?

Yes — one for live, one for testing, as many as you like. Each one is revoked on its own.

What if someone has no username?

They won't come back in the answer. Only people with a username are included — the username is what links the two systems, so without it there's nothing to match on.

How far back can one call go?

93 days per call. For longer, make several calls with ranges that follow on from each other.

Does BasilBook send anything back?

No. It goes one way: BasilBook reads the hours out of DailyBrew. DailyBrew never takes anything from BasilBook or changes anything there.

Which timezone are the times in?

Your shop's — Asia/Phnom_Penh, or whatever you've set. It's included in the answer so BasilBook reads them the right way round.

Comes with Espresso

The BasilBook link and API keys come with Espresso ($19.99/month or $199/year). Usernames for linking across products are Espresso too.

Ready to connect the two?

Start free. Move up to Espresso when you need the link.