Sign in

v1

latestOpenAPI 3.1.0MIT2026-07-243952451019.0 KB
Funnels::ConditionalSplitStep

Create Conditional Split Step

Add a new conditional split step to a funnel. All fields are optional — providing none creates an empty unconfigured split. Provide condition to set the contact filter, branches to attach pages to one or both branches, and/or show_page_step_id to position the split in the workflow.

See the Funnels Skill for the full surface.

post/funnels/{funnel_id}/conditional_split_steps

Path parameters

funnel_idinteger required

Request body

Example request

{
  "conditional_split_step": {
    "condition": {
      "filter_id": "AbCdEf"
    },
    "branches": [
      {
        "page_ids": [
          600,
          601,
          602
        ]
      },
      {
        "page_ids": [
          603
        ]
      }
    ],
    "show_page_step_id": 100
  }
}

Response

Created

idinteger

Conditional split step ID

public_idstring

Obfuscated conditional split step ID

funnel_idinteger

ID of the funnel containing this conditional split

funnel_public_idstring

Obfuscated funnel ID

created_atstring date-time
updated_atstring date-time

Example response

{
  "id": 9876,
  "public_id": "CsXyZ1",
  "funnel_id": 42,
  "funnel_public_id": "xYz123",
  "condition": {
    "filter_id": "AbCdEf",
    "is_setup": true,
    "filter": {
      "id": 42,
      "public_id": "AbCdEf",
      "workspace_id": 5,
      "name": "VIP newsletter audience",
      "filter_class": "ContactsFilter",
      "conjunction": "and",
      "criteria": [
        {
          "attribute": "tags.id",
          "clause": "in",
          "value": [
            "tag-pub-id-1"
          ]
        }
      ],
      "created_at": "2026-04-01T12:00:00.000Z",
      "updated_at": "2026-04-01T12:00:00.000Z"
    }
  },
  "branches": [
    {
      "show_page_step": {
        "id": 200,
        "public_id": "ShPgMa",
        "name": "Matched Page step",
        "current_path": "/matched"
      },
      "page": {
        "id": 600,
        "public_id": "PgMatch",
        "name": "Matched Page"
      }
    },
    {
      "show_page_step": null,
      "page": null
    }
  ],
  "created_at": "2026-05-01T00:00:00.000Z",
  "updated_at": "2026-05-01T00:00:00.000Z"
}