The Alltoogether API
Read your organisation's own people, annual leave and holiday data from your spreadsheets, scripts and apps.
The Alltoogether API is a read-only REST API. It lets your own systems read the people, annual leave and holiday data your organisation keeps in Alltoogether, so a spreadsheet, a people app or a payroll input can stay up to date without anyone re-typing it. Every response is limited to the organisation the credentials belong to.
| Base address | https://api.alltoogether.com (every path starts /v1) |
| Sign-in | OAuth 2.0 client credentials, then a one-hour bearer token |
| What it can do | Read only. Nothing can be created, changed or deleted |
| Format | JSON, snake_case fields, dates as YYYY-MM-DD, times in UTC |
| Interactive docs | api.alltoogether.com/docs, where you can sign in and run requests against your own data |
| Contract | api.alltoogether.com/openapi.yaml (OpenAPI 3.1) |
Start here
Getting access
Switching the API on and creating credentials.
Authentication
Exchanging your credentials for a token.
Reading data
The endpoints and what each one returns.
Paging and sync
Cursors, incremental updates and deletions.
Limits and errors
Rate limits, error shapes and when to retry.
Example: Google Sheets
A working Apps Script that fills a sheet.
The API reference has every endpoint, parameter and response field, generated from the same contract the API serves.