Skip to main content
GHL MCP Guide
WFL

Workflow Lister

Workflows & Surveys · Intermediate · Updated March 2026

List all automation workflows configured in a sub-account with status, trigger types, and integration mapping support.

The Workflow Lister gives you a programmatic view of all automation workflows in a GHL sub-account. This is essential for integration mapping, monitoring, and understanding what automations are running before you build additional systems on top.

What This MCP Tool Does

This tool retrieves every workflow configured in a sub-account including names, publish status, and trigger configurations. You cannot create or edit workflows through the API — that happens in the GHL UI — but you can see everything that exists, which is critical when you are building external integrations that need to interact with or avoid conflicting with existing automations.

Endpoint Reference

List all workflows: GET /workflows Returns an array of all workflows in the sub-account with their names, statuses, and configuration metadata.

Authentication

Requires a Private Integration Token (PIT) with the workflows scope enabled.

Key Parameters

The response includes for each workflow:

  • id — unique workflow identifier
  • name — display name as shown in the GHL UI
  • status — whether the workflow is published (active) or in draft
  • createdAt, updatedAt — timestamps for tracking changes

Important Notes

The workflow API is read-only. You can list workflows and retrieve their metadata, but you cannot create, update, enable, disable, or delete workflows through the API. All workflow management happens in the GHL Workflow Builder UI.

This is still valuable because it lets you inventory automations across sub-accounts programmatically. If you manage 40+ sub-accounts, manually checking each one for workflow status is not practical. This endpoint lets you build a dashboard or audit tool that shows you what is running where.

To trigger a workflow for a specific contact, use the Campaign & Workflow tool instead, which lets you enroll contacts into existing workflows.

Common Questions

Can I trigger a workflow through the API? Not through this endpoint directly. Use the Campaign & Workflow tool to add a contact to a workflow. Alternatively, workflows with webhook triggers can be fired by sending data to the webhook URL configured in the trigger.

Can I see the individual steps inside a workflow? No. The API returns workflow-level metadata (name, status) but does not expose the internal action sequence, conditions, or branching logic. For step-level detail, you need to open the workflow in the GHL UI.

How do I audit workflows across all my sub-accounts? Loop through your locations using the Location CRUD tool, then call the Workflow Lister for each location. This gives you a complete inventory of all active and draft workflows across your agency.

Why would I need to list workflows programmatically? Common use cases include building internal dashboards that show automation status per client, detecting when workflows have been accidentally set to draft, and mapping which workflows exist before deploying new integrations that might conflict.

Back to GHL MCP Guide