Pro
  • Set theme to dark (⇧+D)
    Pro

    How to launch a process using Tallyfy API

    This article provides a step-by-step guide on how to start a process using the Tallyfy API. First, you need to obtain an access token. To achieve this. Head over to Settings > Integrations > REST API, and then click on View your API access token.

    Once you have your token, you can proceed to gather the necessary information.

    This includes:

    • The name of the process
    • The ID of the template
    • Any kick-off field IDs and their corresponding values, as well as the tags and tasks associated with the template.

    Next, you’ll need to prepare your JSON by filling in the required fields such as the process name and the template ID. Make sure to include the tasks and any prerun fields, such as text fields, images, checklists, dropdowns, radio buttons, and dates.

    After preparing your JSON, you can make the API call. Use the POST request type and the URL go.tallyfy.com/api/organizations/{your_org_id}/runs. Don’t forget to include the required headers: 'Accept: application/json' and 'Authorization: Bearer {your_auth_token}'.

    ​​ Request example

    {
       "name": "name of Process",
       "checklist_id": "<Blueprint Id>",
       "summary": "Process summary",
       "owner_id": 0,
       "tasks":  {
           "<Step ID or Step alias>": {
           "position": "<Task position, start from 1>",
           "deadline": "2016-01-01 00:00:00"
           }
        },
        "prerun": [
              {
                  "<prerun_id (if textfields)>": "Text Field Value"
              },
              {
                  "<prerun_id (if images)>": [
                     {
                         "id": "<Id>",
                         "filename": "Image.png",
                         "version": 1,
                         "url": "tallyfy.com/example-image.png",
                         "uploaded_from": "ko_field",
                         "subject": {
                              "id": "<Subject Id>",
                              "type": "Checklist"
                         }
                     }
                  ]
              },
              {
                  "<prerun_id (if checklist)>": {
                       "id": 1,
                       "text": "abc.",
                       "value": "null",
                       "selected": true
                  }
              },
              {
                  "<prerun_id (if dropdown)>": {
                       "id": 1,
                       "text": "abc.",
                       "value": "null"
                  }
              },
              {
                  "<prerun_id (if radio button)>": "Radio Button Value"
              },
              {
                  "<prerun_id (if date)>": "2019-12-12T17:18:55.000Z"
              }
        ],
        "tags":  [
             "<Tag Id>"
        ]
     }
    

    Once the call is made, you will receive a response with a status code of 201. This response will include information about the created process, such as its ID, checklist ID, name, summary, status, progress, and more.

    If you need assistance with integrations or advanced features, feel free to contact Tallyfy Support for additional services.

    Now you’re ready to start your process using the Tallyfy API! Happy automating!