Create funnel (legacy)

Create a new funnel, assign it a name and description matching your business needs.


This endpoint is for Audience Studio legacy. For the latest Audience Studio, contact your Customer Success Representative.

SecurityTdApikeyAuth
Request
path Parameters
audienceId
required
integer <int64>

Master Segment ID

Request Body schema: application/json
required

Funnel parameters to create

name
required
string

name

description
string

description

segmentFolderId
required
integer <int64>
required
Array of objects [ 3 .. 8 ] items

funnel stages

Responses
200

Succeeded to create funnel

400

Given parameters are not valid

401

Unauthorized; You don't provide valid credentials. Maybe you didn't specify valid TD's Master API Key as 'TD1 {Your TD Master API Key}'.

403

Requested resource or action is not allowed because you don't have sufficient permissions

404

The specified resource was not found

4XX

There is a high possibility of error of the authentication system. Please check the contents and authority of the key. Please contact the TD support team if you do not resolve it.

5XX

System error. Because there is a possibility of a temporary error due to network trouble and so on, we recommend several times retry on request side. Please contact the TD support team if you do not resolve it.

post/audiences/{audienceId}/funnels
Request samples
application/json
{
  • "name": "string",
  • "description": "string",
  • "segmentFolderId": 0,
  • "stages": [
    ]
}
Response samples
application/json
{
  • "id": "string",
  • "audienceId": "string",
  • "segmentFolderId": "string",
  • "name": "string",
  • "population": 0,
  • "description": "string",
  • "numSyndications": 0,
  • "needToRunWorkflow": true,
  • "stages": [
    ],
  • "createdAt": "2019-08-24T14:15:22Z",
  • "updatedAt": "2019-08-24T14:15:22Z",
  • "createdBy": {
    },
  • "updatedBy": {
    }
}