cotera
Logo

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.

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:

{
  "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