Tomorro provides a public GraphQL API allowing you to both receive and send data.
The possibilities are numerous and concretely allow you to perform almost all possible operations on our platform. It's the same API we use internally for developing our applications and providing connections to other tools.
Our API V1 (GraphQL) will be deprecated. If you are starting a new integration project, we encourage you to use API V2 (REST): https://alpha.developer.tomorro.com/quickstart
Developpers documentation
Our API documentation: https://developers.tomorro.com/welcome
Queries → All the possibilities for extracting data from Tomorro to third-party software
Mutations → All the possibilities for sending data from third-party software to Tomorro.
Our webhook documentation: How to use them / Technical documentation
What the V2 (REST) API covers
The V2 API notably allows you to:
Members: list all the members of your organization (GET /v2/members), fetch a member (GET /v2/members/:id), create or update one.
Custom tables (custom objects): list your tables (GET /v2/custom-objects), read the structure and columns of a table (GET /v2/custom-objects/:id), add or update the rows of a table on a contract (PUT /v2/custom-objects/:customObjectId/contract/:contractId/records).
Contracts: list and read contracts, including the values of their custom fields (GET /v2/contracts, GET /v2/contracts/:id).
Custom fields: list fields (GET /v2/smart-fields) and the options of list-type fields (GET /v2/smart-fields/:id/options).
Reading the rows of a custom table is not yet available via the API (only writing is). The full list of endpoints and their schemas is available in the V2 developer documentation.
Glossary
API Name | Tomorro Name |
type | Contract types |
template | Template |
contract | Contract |
document | Contract document |
externalCompany | Counterparty |
attributeDefinition | Smart field |
Authentification & Setup
Endpoint : https://api.tomorro.com/graphql
Content-Type : application/json
X-API-KEY : YourAPIKey
A personal API key can be generated in the Tomorro application.
Go to
https://app.tomorro.com/integrationsGo to the API section > Generate an API key
Tips
You can find all ids directly in the URL (available for contract types, contracts, counterparties...).
"GraphQL Network Inspector" can help you to visualise all live requests while using the app.
Download it
While using Tomorro > Right click > Inspect
Go to "GraphQL Network"
