Developer API & OEM API | Apr 17, 2026

The folder_id parameter is becoming required on three Developer API and OEM API endpoints that create assets. This supports the deprecation of the “Home Asset” folder and enables cleaner root folder structure and improved workspace organization.

POST /connections – folder_id must be specified when creating a new connection.
POST /recipes – folder_id must be specified when creating a new recipe.
POST /recipes/:recipe_id/copy – folder_id must be specified when copying a recipe.
Requests made without folder_id after May 7, 2026 will return an error response. Note that error formats vary by endpoint (HTTP 200 with error body, HTTP 422, or HTTP 400).
What you need to do:
Create a new folder in your Workato workspace (or use an existing one) and retrieve its folder_id.

Update your API calls to include the folder_id parameter before May 7, 2026.
If you have questions, contact your Customer Success Manager or reach out to Support.

Learn more about the Developer API.