Skip to main content

Trigger a workflow via callouts


Trigger a workflow via callouts

You can run a workflow via an API call. Depending on the authentication methods you use, the API endpoints and supported modes are different.


You can also call a standard Zuora API operation to run a workflow. You need to generate a bearer token first, and use the token to call this endpoint:


Based on the environment you are using, <base_url> is different. 

If you do not know the workflow ID, you can use the Get workflows operation to retrieve all workflows first and find the ID of the workflow in the payload of the response. 

To learn about all available Workflow APIs, see Workflow APIs in the API Reference.

To learn more about authentication for Zuora standard APIs, see Authentication in the Developer Center.

API-token or basic authentication

Before you start, ensure that the Callout trigger is enabled for the workflow that you want to run.

To run a workflow using API-token or basic authentication, send GET or POST request to the endpoints listed below. The API endpoint can be the standard API endpoint displayed in the settings of the workflow, or the responsive API endpoint. Use the responsive API endpoint only when you are familiar with the responsive mode of Workflow. 

Standard API endpoint:


Responsive API endpoint:


Where {workflow_id} is different for each workflow.

For API-token authentication, you need to place the key pair in the header. The key must be "API-Token". The actual token is displayed on the settings page of the workflow.

For basic authentication, the username and password are also displayed on the settings page of the workflow.