Build your own connection to Soon.
Connect your own tools to the schedule. Soon’s REST API gives developers an explicit interface for boards, shifts and assignments.
What you can do with the REST API.
Boards, shifts and assignments
Build workflows around the documented REST endpoints. The developer reference lists supported operations and request examples.
Scoped team keys
The team owner creates API keys on the Developers tab and limits their permissions to what each tool needs.
Different from MCP
Use REST for an application you build with team API keys. MCP connects an AI client using a person’s own Soon sign-in and access.
3 steps to get started.
- Read the API reference and choose the operations your workflow needs.
- Have the team owner create an API key with the required permissions.
- Build and test the connection, keeping the key on your server rather than in browser code.
Use the developer reference as the contract for supported operations. A REST API key is not an MCP sign-in.
Open the developer referenceQuestions about the REST API.
Yes. With leaves:write permission, create a pending leave request or update its status. Approval requires checking overlapping shifts and explicitly choosing whether to keep or cancel them. See the API documentation for the current contract.