Create new funnel

Creates a new video funnel for the authenticated user's organization

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

POST /funnels/create

Creates a new video funnel inside the authenticated user's organization. A matching folder is created in Panda Folders so videos added to the funnel are auto‑grouped there.

📘

Authorization

Requires a valid API Key in the Authorization header. Send the key directly — no Bearer prefix.

HTTP Method & Path

POST /funnels/create

Base URL: https://api-v2.pandavideo.com.br

Authentication Requirements

HeaderValue
Authorization<your-api-key> (no Bearer prefix)

Request Body

Content-Type: application/json

Body Parameters

FieldTypeRequiredDescription
namestring (3–50)yesFunnel display name. Must be unique inside the organization.
{ "name": "Sales Funnel Q1" }

Response

Success Response (201)

{
  "message": "Funnel created successfully",
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Sales Funnel Q1",
    "organization_id": "11111111-2222-3333-4444-555555555555",
    "folder_id": "99999999-8888-7777-6666-555555555555"
  }
}

Response Schema

FieldTypeDescription
data.idstring (uuid)Funnel identifier.
data.namestringFunnel name (echoes input).
data.organization_idstring (uuid)Owning organization.
data.folder_idstring (uuid) | nullFolder auto‑created in Panda Folders. null if folder creation failed (funnel is still created).

Error Responses

  • 400name shorter than 3 / longer than 50, or a funnel with the same name already exists in the organization ("Funnel with the same name already exists.").
  • 401 — missing/invalid API Key.
  • 500 — internal error.

Example Usage

cURL

curl --request POST \
  --url 'https://api-v2.pandavideo.com.br/funnels/create' \
  --header 'Authorization: <your-api-key>' \
  --header 'Content-Type: application/json' \
  --data '{ "name": "Sales Funnel Q1" }'

Recipes

Body Params
string
required
length between 3 and 50

Name of the funnel

Responses

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json