---
title: "Create a code-managed funnel"
method: POST
path: "/funnels"
---

# Create a code-managed funnel

`POST /funnels`

## Request

- Base URL: `https://gringofunnels.com/api/v1`
- URL: `https://gringofunnels.com/api/v1/funnels`
- Auth: HTTP bearer

## Request body

- FunnelCreate
  - `name` string, required
  - `type` string
  - `slug` string
  - `contentOrigin` union, required
    - object
      - `kind` 'original', required
    - object
      - `kind` 'educational_recreation', required
      - `sourceName` string, required
      - `sourceUrl` string, uri, required
      - `originalCreator` string, required
      - `excludedDeliverables` string[], required

## Response `201`

Funnel created

## Other responses

- `401`: Missing or invalid API key
- `403`: The scoped credential does not grant this operation
- `422`: Invalid query parameters

---

[API](https://skmtc.dev/gringofunnels/apis/gringo-funnels-api.md) · [All operations](https://skmtc.dev/gringofunnels/apis/gringo-funnels-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gringofunnels/apis/gringo-funnels-api/revisions/b57b5e365b56?raw)