# Retool

> Internal tool builder for triggering workflows via API. Retool workflows allow automated data processing and integrations.

Source: https://cotera.co/docs/reference/tools/individual-tools/retool

---

**Authentication Type:** API Key
**Description:** Internal tool builder for triggering workflows via API. Retool workflows allow automated data processing and integrations.

***

## Authentication

To authenticate, you'll need a Retool workflow API key:

1. Open your Retool workflow in the editor
2. Click the **Webhook** trigger block
3. Copy the **Workflow API Key** from the trigger settings
4. Your base URL is typically `https://api.retool.com` (or your self-hosted instance URL)

For more information, visit the [Retool Workflows documentation](https://docs.retool.com/workflows/quickstarts/external-trigger).

***

## Workflows

### Trigger Workflow

Trigger a Retool workflow by ID with an optional JSON body. Returns the workflow result data.

**Operation Type:** Mutation (Write)

**Parameters:**

* **workflowId** `string` (required): The ID of the Retool workflow to trigger
* **body** `string` (nullable): JSON-encoded body to pass to the workflow (e.g. `{"email": "user@example.com"}`), or null for no body

**Returns:**

* **success** `boolean`: Whether the workflow was triggered successfully
* **data** `object` (nullable): Data returned by the workflow, if any

**Example Usage:**

```json
{
  "workflowId": "wf_abc123def456",
  "body": "{\"customer_id\": \"cust-789\", \"action\": \"sync_data\"}"
}
```

***

## Common Use Cases

**Workflow Automation:**

* Trigger data sync workflows from external events
* Kick off approval processes with contextual data
* Run scheduled data processing jobs on demand

**Internal Tool Integration:**

* Connect AI agents to existing Retool workflows for complex operations
* Pass structured data to workflows for processing and transformation
* Retrieve workflow results for use in downstream automation

**Data Processing:**

* Trigger ETL pipelines built in Retool workflows
* Run bulk data operations with custom parameters
* Orchestrate multi-step processes across internal tools