# Add a funnel: its steps, in order

> tidekeeper's API reference: https://tidekeeper.eu/docs/api/post-sites-site-funnels

`POST /api/v1/sites/{site}/funnels`

Add a funnel: its steps, in order.

## Parameters

- `site` (in path, needed): A site's id or name

## What to send

`FunnelCreate`

- `name` (string, needed)
- `spec` (object, needed)

## The answer

201, `FunnelView`

- `id` (string, needed)
- `name` (string, needed)
- `spec` (object, needed)
- `steps` (list of string, needed): Each step in words.

## Asking

```sh
curl -X POST https://tidekeeper.eu/api/v1/sites/example.org/funnels \
    -H "Authorization: Bearer $TIDEKEEPER_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{"name": "…", "spec": {}}'
```