Skip to content
Tallyfy

Launch via API

Full-seat members

Start a Tallyfy process automatically from another system

You can have another system start a Tallyfy process for you, with nobody clicking a button. When a deal closes in your CRM, a customer onboarding process can kick off on its own. When someone submits a form, the matching workflow starts and tracks itself. Your developer sets this up once using Tallyfy’s API1, and from then on it just runs.

This is for teams that want their tools to talk to each other. If you’d rather start a process by hand, by email, or from a public form, see the other trigger options.

What another system can set when it starts a process

  • Pre-fill your kick-off form fields with data it already has, like the customer’s name, the deal value, or a start date
  • Give the process a clear name so it’s easy to find later
  • Assign the right people, groups, and roles to each step
  • Set deadlines
  • Tag the process and drop it in the right folder

Common ways people use this

  • CRM: start onboarding the moment a deal closes
  • Document management: kick off an approval when a file is uploaded
  • Sensors and devices (IoT): launch an inspection when a sensor raises an alert
  • External forms: create a process from a form filled out on another site
  • Databases: start a workflow when a record changes

For developers

(Skip this unless you’re setting up the technical side.)

To launch a process, send a POST request to Tallyfy’s REST API. You trigger it from your own code, which runs when something happens in another system: a CRM deal closing, a form submission, a sensor alert, and so on.

What you’ll need

  • A Tallyfy account with API access
  • An OAuth Bearer token for authentication
  • The checklist_id (template ID) you want to launch
  • Familiarity with REST APIs and JSON

How to launch a process

  1. Get your access token - set up OAuth in Tallyfy and store your Bearer token securely.
  2. Find the template ID - grab the checklist_id from the URL when you’re viewing your template, and note any kick-off form fields that need data.
  3. Send the POST request - call POST /organizations/{org_id}/runs with a JSON body containing checklist_id and process details.
  4. Handle the response - you’ll get a 201 response with the new process data, including its ID. Add error handling for failures.

Pass extra data through the prerun object to pre-fill kick-off form fields. You can also set the process name, per-step assignments (users, groups, and roles), and deadlines in the same request.

Sample API request

POST /organizations/{org_id}/runs HTTP/1.1
Host: go.tallyfy.com
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json
X-Tallyfy-Client: APIClient


{
  "checklist_id": "your-template-id",
  "name": "Customer Onboarding - Acme Corporation",
  "prerun": {
    "customer_name": "Acme Corporation",
    "contract_value": 15000,
    "start_date": "2024-01-15T00:00:00.000Z"
  }
}

See the API process launch guide for full details.

Launching > Triggers

Tallyfy offers seven ways to start a process, from manual clicks and form submissions to API…

Footnotes

  1. A way for other software to talk to Tallyfy directly, sending and receiving data without anyone using the screen. ↩

Get in touch
About Tallyfy