API keys
Create a read-only key so your own scripts and reports can read your plan and client time.
The DaySmith API lets your own scripts, spreadsheets and reporting tools read what DaySmith knows: your plan, your clients, and how much client work was planned. It is read-only. A key can never change your calendar, tasks or settings.
Create a key
- Open Settings and expand Calendar feed and API.
- Click + New API key and give it a name you'll recognize later, such as "Monthly client report".
- Choose what it may read. Leave out anything the script doesn't need.
- Choose when it expires: 30 days, 90 days, 1 year, or never.
- Click Create key, then Copy. Store it somewhere safe, such as a password manager.
DaySmith shows a key only once. It keeps just a fingerprint of the key, so nobody, including DaySmith support, can show it to you again. If you lose it, delete it and create a new one.
What a key can read
| Permission | Lets the key read |
|---|---|
| Read your plan | Your meetings with their titles and clients, your planned work, and work that didn't fit, for up to 14 days at a time. Also your name, time zone and work hours. |
| Read clients and client time | Your clients, their Lists and work rules, their monthly limits, and the minutes of their work planned each day. |
No key can read your password, billing details, the keys DaySmith uses to reach your tools, meeting notes, attendee email addresses, or join links.
Use a key
Send the key in the Authorization header of each request:
curl -H "Authorization: Bearer ds_k_your_key_here" https://api.getdaysmith.com/v1/plan
The API reference lists every endpoint and what it returns.
Keep keys safe
- One key per script. Then you can delete one without breaking the others.
- Never put a key in a web page or in code that other people can see.
- Check "last used". Each key in Settings shows when it was last used. Delete keys you don't recognize or no longer need.
- Delete a key that leaked. Click Delete next to it in Settings. It stops working right away.
You can have up to 10 keys. Keys only work while your DaySmith subscription is active.
Didn't answer your question? Email support.