Connect your business data
Clients, projects, tasks, partners, company people and business cards. The official API for reading and writing Tooon's business data from your own site and internal tools. Tooon Connect, for bringing Tooon to your own service's members, is part of this API too.
Available on Solo and up.
Tooon's business data, as it is.
All of it is the same data you see in the Tooon app.
- Clients
List, search, add, and update details or status. Attach your own ID to add without duplicates.
- Projects
Create, change content, status and parent, list and search.
- Tasks
Create, change content, owner, due date and status. Get the list of people who can own them too.
- Partners and service contracts
Add and update contractors and contracts. Draft and send invoice requests.
- Company people and member cards
Add employees and contract staff, and create, update and publish their business cards.
- Company card
Read your published intro, offerings and work to show them on your own site.
Pick the access,
An admin creates keys in Settings → Integrations → API keys, choosing a name and access. Clients only for a contact form, tasks only for an internal tool. Keep a key per job, and turn any of them off at any time.
Solo and upWhat people decide
Approving and paying invoices, inviting members and changing roles can't be done through the API, whatever access a key has. Tooon keeps what runs automatically apart from what people check.
Apps like these
Build the screens and experience yourself, and leave business systems like clients, contracts, invoices and business cards to Tooon. Split the front from what's behind it like this, and there's far less to build.
- Teams that work with contractors and freelancers
Run contracts and invoices with outside people through your own system
- Front (your app)
- Sign-up forms, a portal for your contractors
- Behind it (Tooon)
- Adding partners and service contracts, drafting and sending invoice requests
partnersinvoice_requests - Client portals for studios and professional firms
Show clients how their project is going, on your own screens
- Front (your app)
- A portal clients log in to, progress views
- Behind it (Tooon)
- Projects and tasks for each client, with owners and due dates
clientsprojectstasks - Contact and booking forms
Turn incoming inquiries straight into work
- Front (your app)
- Contact forms, booking pages, chat
- Behind it (Tooon)
- Adding the client, creating follow-up tasks
clientstasks - Company and careers sites
Stop updating your work and team in two places
- Front (your app)
- Your site's design and articles
- Behind it (Tooon)
- Company card offerings and work, company people and business cards
company_pagepeoplebusiness_cards - HR and internal portals
Stop fixing business cards and staff lists by hand after every hire or move
- Front (your app)
- Your HR system, internal portal
- Behind it (Tooon)
- Adding and updating company people, creating and publishing business cards
peoplebusiness_cards - Expense and reimbursement apps
Let people claim what they paid for from your own form
- Front (your app)
- Expense claim form, receipt photos
- Behind it (Tooon)
- Recording expenses with receipts, status through to reimbursement
expensessettlements
Member services,
Tooon Connect is the part of the Tooon API for bringing Tooon's features to your own service's members. Members stay logged in to your service and use digital business cards and tools for their own business. Early access is open now.
No surprises
Every operation follows the same rules. The details are in the reference.
- Retries never double up
Add an Idempotency-Key to writes, and if the connection drops and you resend the same values, you get the same result as the first time.
- Connect with your own IDs
Add with an externalRef and it stays one record however many times you call it. Easy to match with your own data.
- Access per key
Choose read or write for each area. Anything outside a key's access comes back as an error with the reason.
- Up to 60 calls a minute
The limit is per key. Response headers tell you how many calls are left.
- Use it from your server
A key is shown once, when it's created, and Tooon doesn't keep the original value.
- Reference built from the definition
The reference is generated from the API's own definition. The OpenAPI definition is public too.
Connected in three steps.
- 1Move to Solo or up
The API works in Solo, Pro and Business workspaces.
- 2Create an API key
An admin creates it in Settings → Integrations, with a name and access. Keep the key in your server’s environment variables.
- 3Call it as documented
Start with GET /api/v1/me to check the key and the workspace.
Before you connect, start here.
Make Tooon part of how your business runs.
On Solo and up, create an API key and start right away.