# Destinations

Destinations are the Slack, Microsoft Teams, Discord, Google Chat, Mattermost and Telegram chats and the webhooks flows deliver to. Email needs no destination.

## List destinations

`GET https://formpik.com/api/v1/destinations`

## Read one destination

`GET https://formpik.com/api/v1/destinations/{id}`

*200 OK*

```json
{
  "data": {
    "id": "dst_s4l2c8k1q0",
    "kind": "webhook",
    "name": "CRM",
    "target": "",
    "url": "https://crm.yourcompany.com/hooks/formpik",
    "signing_secret": "whsec_...",
    "created_at": "2026-11-04T12:00:00.000Z"
  }
}
```

> **What read only keys see**
>
> Keys with full access get the whole `url` and, for webhooks, the `signing_secret` to check signatures with. Read only keys get the address shortened to its host and `signing_secret` as `null`, the same as viewers in the dashboard.

## Connect a destination

`POST https://formpik.com/api/v1/destinations`

Answers `201`. A webhook gets its signing secret here. Needs a key with full or admin access.

**Body**

- `kind` (string, required): `slack`, `teams`, `discord`, `googlechat`, `mattermost`, `telegram` or `webhook`. It cannot change later. For Telegram, `target` is the chat ID.
- `url` (string, required): The incoming webhook address from Slack, Teams or Discord, or your own https address. Private network addresses are refused.
- `name` (string): Up to 100 characters.
- `target` (string): A note shown in the dashboard, such as the channel: `#sales-leads`.

*cURL*

```bash
curl -X POST "https://formpik.com/api/v1/destinations" \
  -H "Authorization: Bearer $FORMPIK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind": "slack", "name": "Sales channel", "target": "#sales-leads", "url": "https://hooks.slack.com/services/..."}'
```

## Change a destination

`PATCH https://formpik.com/api/v1/destinations/{id}`

Send any of `name`, `target` and `url`. Needs a key with full or admin access.

## Disconnect a destination

`DELETE https://formpik.com/api/v1/destinations/{id}`

Steps that delivered to it need a new destination before their flows can go live again. Needs a key with full or admin access.

To use one in a flow, put its id in a step's `destination_id`. See [Steps and connections](https://formpik.com/docs/api/flows#shape).

---

Source: https://formpik.com/docs/api/destinations
