# Funnels

One of the challenges of targeting customers with relevant campaigns is understanding where they are in their customer journey. Many organizations use the traditional marketing funnel to understand where their customers are in the buying process. Knowing where customers are in the marketing funnel allows organizations to create campaigns and analyze customer behaviors that are specific to individual customers or customer groups. Being able to use all available customer data to accurately identify exactly in which stage customers are in gives marketers a clear advantage. <br> <br> Treasure Data offers Funnels, a premium subscription feature in Audience Studio, which provides this advantage to its users. Funnels make it easier for marketers to see exactly where their customers are in the buying process, allowing them to create more customer-tailored marketing campaigns using multi-channel activations.<br> <br> Funnels enables marketers to create and customize a marketing funnel with up to eight stages in the Audience Studio to reflect the exact buying experience of their customers. After the Funnel stages have been created, marketers can further analyze and refine the stages and activate specific stages for campaigns.

## List of funnels

 - [GET /audiences/{audienceId}/funnels](https://td-public.redocly.app/apis/audience_api_v1/funnels/funnels_index.md): Retrieves a list of funnels associated with a parent segment identifier and its stages.

## Create funnel (legacy)

 - [POST /audiences/{audienceId}/funnels](https://td-public.redocly.app/apis/audience_api_v1/funnels/funnels_create.md): 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._

## Retrieve funnel by ID

 - [GET /audiences/{audienceId}/funnels/{funnelId}](https://td-public.redocly.app/apis/audience_api_v1/funnels/funnels_show.md): Search and find a specific funnel by its identifier.   

## Update funnel (legacy)

 - [PUT /audiences/{audienceId}/funnels/{funnelId}](https://td-public.redocly.app/apis/audience_api_v1/funnels/funnels_update.md): Update a funnel.    _This endpoint is for Audience Studio legacy. For the latest Audience Studio, contact your Customer Success Representative._

## Delete funnel (legacy)

 - [DELETE /audiences/{audienceId}/funnels/{funnelId}](https://td-public.redocly.app/apis/audience_api_v1/funnels/funnels_delete.md): Delete a funnel.    _This endpoint is for Audience Studio legacy. For the latest Audience Studio, contact your Customer Success Representative._

## Clone funnel

 - [POST /audiences/{audienceId}/funnels/{funnelId}/clone](https://td-public.redocly.app/apis/audience_api_v1/funnels/funnels_clone.md): Make a copy of a funnel.

## Retrieve the population statistics of a funnel and its funnel stages

 - [GET /audiences/{audienceId}/funnels/{funnelId}/statistics](https://td-public.redocly.app/apis/audience_api_v1/funnels/funnels_statistics.md): Retrieve the population history of a funnel. The history is returned per day and those days are calculated in the timezone of the audience.

## Create funnel

 - [POST /entities/funnels](https://td-public.redocly.app/apis/audience_api_v1/funnels/paths/~1entities~1funnels/post.md): Create a funnel.

## Retrieve funnel by ID

 - [GET /entities/funnels/{id}](https://td-public.redocly.app/apis/audience_api_v1/funnels/paths/~1entities~1funnels~1%7Bid%7D/get.md): Retrieve a funnel by ID.

## Update funnel

 - [PATCH /entities/funnels/{id}](https://td-public.redocly.app/apis/audience_api_v1/funnels/paths/~1entities~1funnels~1%7Bid%7D/patch.md): Update a funnel.

## Delete funnel

 - [DELETE /entities/funnels/{id}](https://td-public.redocly.app/apis/audience_api_v1/funnels/paths/~1entities~1funnels~1%7Bid%7D/delete.md): Delete a funnel.

## Retrieve population statistics of funnel stage

 - [GET /entities/funnels/{funnelId}/stages/{id}/statistics](https://td-public.redocly.app/apis/audience_api_v1/funnels/paths/~1entities~1funnels~1%7Bfunnelid%7D~1stages~1%7Bid%7D~1statistics/get.md): Retrieve the population history of the audience. The history is returned per day and those days are calculated in the timezone of the audience.

## Retrieve list of funnel by parent segment

 - [GET /entities/parent_segments/{parentSegmentId}/funnels](https://td-public.redocly.app/apis/audience_api_v1/funnels/paths/~1entities~1parent_segments~1%7Bparentsegmentid%7D~1funnels/get.md): Retrieve a list of funnels based on a parent segment.