--- title: "Create Funnel" method: POST path: "/workspaces/{workspace_id}/funnels" tags: ["Funnel"] --- # Create Funnel `POST /workspaces/{workspace_id}/funnels` Create a new funnel in the workspace. Creating a funnel automatically creates a workflow. You can then add pages to the funnel by creating pages with `funnel.funnel_id` set to the new funnel's ID (see the Create Page endpoint). **Client flow for building a funnel with pages:** 1. `POST /api/v2/workspaces/:id/funnels` — creates the funnel (workflow auto-created) 2. `POST /api/v2/workspaces/:id/pages` with `{ page: { name: "...", funnel: { funnel_id: "" }, markup: "" } }` — creates each page, auto-links it to the funnel, and applies the markup in one call 3. `PATCH /api/v2/pages/:id` with `{ page: { markup: "" } }` — applies or updates visual content (PML markup) on an existing page 4. Steps 2 and 3 can be combined: passing `markup` in the create call sets the initial visual content without a separate PATCH The internal step/workflow wiring is handled automatically — API clients never need to manage workflows or steps directly. ## Path parameters - `workspace_id` integer, required ## Request body - object - `funnel` FunnelParametersCreate — Funnels - `name` string, required — Name of the Funnel - `current_path` string — The URL path for the funnel. If not provided, a path will be auto-generated from the name. - `live_mode` boolean — In Live Mode your Funnel cannot be tested and will process live payments - `domain_id` integer, nullable — The ID of the domain to associate with this funnel. Use the Domains API to look up available domain IDs. - `tag_ids` integer[] — An array of tag IDs to associate with this funnel - `head_code` string, nullable — Custom code to inject into the funnel's section. Content should be wrapped in appropriate HTML tags such as