Skip to content

Complete form fields in a task

How to complete form fields in a task using the API

Important - if you make API calls directly to the Tallyfy API endpoint, you must supply an additional header in your requests X-Tallyfy-Client: APIClient otherwise your requests will be dropped.

To complete form fields in a process task, follow these steps:

  1. Gather your information: Make a GET request to go.tallyfy.com/api/organizations/{org}/me/tasks to obtain the necessary information for updating the task.

  2. Decide how to proceed: To fill out the form fields and mark the task as complete, send a POST request to https://go.tallyfy.com/api/organizations/{org}/runs/{run_id}/completed-tasks. If you only want to update the task without marking it as complete, send a PUT request to https://go.tallyfy.com/api/organizations/{org}/runs/{run_id}/tasks/{task_id}.

  3. Submit your payload: Whether you’re marking the task as complete or just updating it, use the following payload structure - this example is for a short text field:

{
  "taskdata": {
    "${id_of_field_to_be_completed}": "${desired_value}"
  }
}

Other field types

This example shows you a POST request to this endpoint for other field types:

https://go.tallyfy.com/api/organizations/{org}/runs/{runID}/tasks/{taskID}

Examples for multiple field types below.

{
    "taskdata": {
        "e4238158ad0949d4ad78c55125b28a99": "normal text field", // Text
        "ad789434de1c4d5fade2193d237c5716": "Text Area content", // Textarea
        "7a54e215a9904096851360917080599f": "yes", // Radio box
        "8c0161f92eba4d3da7182fed348f3421": "2024-12-20T14:23:18.128Z", // Date
        "0e4b280880cc4407a06478a2faa8052b": { // select dropdown
            "id": 2,
            "text": "Offiice 365",
            "value": null
        },
        "fe316c2ac44a421cafbf128c9462b8e9": [ // Multiselect Checkboxes
        {
            "id": 1,
            "text": "Slack",
            "value": null,
            "required": true,
            "selected": true
        },
        {
            "id": 4,
            "text": "forms",
            "value": null,
            "selected": true
        }]
    }
}

Remember - if you’re not sure how API calls work - just sniff the existing calls on the client UI to see what calls the client UI is making. Search for “sniff” on our product documentation to find the article that shows you how to do this.

If you need assistance with integrations and advanced features, contact Tallyfy Support for additional services.

Launching > Launch a process from a web form

Streamline workflow efficiency by automatically populating Tallyfy process fields through a web form integration that uses query parameters to fill required information from user submissions.

Open Api > Launch a process using Tallyfy API

Starting a process through Tallyfy API requires obtaining an access token preparing JSON with process details and making a POST request to the API endpoint with appropriate headers and task assignment configurations.

Tasks > Types of form fields

Tallyfy offers diverse form field options including short text long text dropdown lists checklists radio buttons date/time fields file uploads tables and assignee pickers with customizable settings for efficient data collection in workflows.

Open Api > Attach files using the API

Files can be attached to task fields through the Tallyfy API either by uploading local files using a POST request or by linking external files using a PUT request with specific JSON payloads and authentication tokens.
Get in touch
About Tallyfy