---
title: "Run workflow"
method: POST
path: "/workflows/{idWorkflow}/trigger"
tags: ["Workflows"]
---

# Run workflow

`POST /workflows/{idWorkflow}/trigger`

## Request

- Base URL: `https://api.toriihq.com/v1.0`
- URL: `https://api.toriihq.com/v1.0/workflows/{idWorkflow}/trigger`
- Auth: API key in header `Authorization`

Triggers a workflow.

`triggerUserEmail` should be provided for the following workflow triggers: "User meets criteria", "User joins", "User left", "Closed app in use", "License not in use" and "App event".

`triggerAppId` should be provided for the following workflow triggers: "Application meets criteria", "Closed app in use" and "New app discovered".

`triggerContractId` should be provided for the following workflow triggers: "Contract meets criteria".

`triggerLicenseName` and `triggerLicenseAppId` should be provided for the following workflow triggers: "License not in use".

`triggerPayload` is the JSON payload for the "Custom trigger (Webhook)" trigger; its fields are the ones in the workflow's sample payload. Other triggers ignore it.

*   Rate limit: 100 requests per minute

## Path parameters

- `idWorkflow` integer, required

## Request body

- ManuallyRunWorkflow: Manually run workflow
  - `triggerAppId` number: Unique identifier of the triggered application
  - `triggerUserEmail` string: The email of the triggered user
  - `triggerContractId` number: Unique identifier of the triggered contract
  - `triggerLicenseName` string: The name of the triggered license
  - `triggerLicenseAppId` number: Unique identifier of the app in the triggered license
  - `triggerPayload` TriggerPayload: The payload for a "Custom trigger (Webhook)" workflow

## Response `200`

Standard Response

- Model98: Standard Response
  - `success` boolean

---

[API](https://skmtc.dev/toriihq/apis/torii-api-documentation.md) - [All operations](https://skmtc.dev/toriihq/apis/torii-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/toriihq/apis/torii-api-documentation/revisions/15fd1512591b?raw)