Knowledge base
Connections, auth and API
Connection errors, access keys, pagination and REST API calls.
19 answers· 1 tips
Answers
- FixWhy does my integration fail with "<!DOCTYPE html>", "Socket hang up", "No healthy upstream" or 502?These are transient server-side errors; rerun the failed run from Run history, and reconfigure old or duplicated steps if failures repeat.
- FixWhy does my integration fail with invalid_grant, insufficient access or KISSFLOW_ERROR_10220?Reauthenticate the connection with an active account that has admin access to every flow the integration touches, ideally a service account.
- FixWhy does my dataset API call or integration process only part of my records?List APIs page their results, and integration actions cap rows at 100 or 200. Page through the API, or batch larger loads.
- How-toHow do I connect Kissflow to an app that has no built-in connector?Check the connector list first, then call the app's REST API with the HTTP connector, or build your own connector.
- How-toHow do I create, update or delete dataset records in bulk with the API?Send up to 500 records per call to the dataset batch endpoint as a JSON array in the Data form field; include _id to update.
- How-toHow do I authenticate Kissflow API calls and find the account, process and instance IDs?Send X-Access-Key-Id and X-Access-Key-Secret headers to your account domain, and read the IDs from API authentication and the item URL.
- FixWhy does the API return only 10 or 100 items, or time out when I fetch everything?List endpoints are paginated. Page through results with page_number and page_size instead of asking for everything in one call.
- How-toHow do I get data from an external system into a process?Import or sync the data into a dataset, connect MySQL or MSSQL with an external data object, call the system's API with the HTTP connector, or receive it with Catch a webhook.
- FixWhy do I get "fetch is not defined" in the Run JavaScript step, and how do I call an external API?Run JavaScript runs server-side without browser APIs. Call the API with the HTTP connector or kf.api(), and use the script only to shape data.
- How-toCan I get report data, including child tables, through the API?The API exposes report counts, report fields and single report items, not a full report export. Export from the UI or page through the admin items API.
- How-toHow do I get a report ID or field IDs for the API?Read the report ID from the report's URL, then call the report fields endpoint to get each field's ID and type.
- How-toHow do I get all board items through the API?There's no single 'get all items' board endpoint; list an unfiltered view, or loop over item IDs.
- How-toHow do I use an HTTP call's response to decide where the workflow goes next?Write the response into a hidden field with Update an item, then route on that field with a Goto or condition in a later step.
- FixWhy do I get a CORS error when a custom component calls the API in the development environment?Don't hard-code the production domain. Call the API with a relative path so it works in every environment.
- How-toHow do I get app roles and their users through the API?Call the user API, whose output includes the user's app roles, or fetch user data with the Kissflow User details connector in an integration.
- How-toHow do I update a board item's start date through the API?The due-date endpoint doesn't change the start date; send _start_date in the board item update call.
- How-toIs there an API to set task delegation for users?Delegation isn't in the public API reference. Set it from My settings or, as a Super Admin, from Account administration.
- How-toMy API access key is about to expire. How do I renew it?Create a new access key, switch every integration and API client to it, then turn off or delete the old key.
- How-toWhat is the difference between the "lookup" and "remote lookup" list APIs?Both return every option a field can show for an item, not the selected value; lookup reads Kissflow data and remote lookup reads an external API.