---
title: "Create a destination"
method: POST
path: "/api/me/destinations"
tags: ["me"]
---

# Create a destination

`POST /api/me/destinations`

## Request

- Base URL: `https://api.signalraven.ai`
- URL: `https://api.signalraven.ai/api/me/destinations`
- Auth: none declared

Customer-side modal supports slack, google_sheet, webhook, notion, n8n, clay_webhook, pipedrive, attio. Slack, Pipedrive and Attio are created through their OAuth callbacks, not this endpoint. See CreateMeDestinationSchema for the allow-list.

## Request body

- CreateMeDestinationBody
  - `destinationType` 'slack' | 'google_sheet' | 'webhook' | 'notion' | 'n8n' | 'clay_webhook' | 'pipedrive' | 'attio', required
  - `name` string, required
  - `config` object, required
  - `routing` union
    - object
      - `mode` 'all', required
    - object
      - `mode` 'manual', required
    - object
      - `mode` 'min_strength', required
      - `minStrength` integer, required

## Response `201`

Created destination

- Destination
  - `id` string, uuid, required: Destination ID
  - `customerId` string, uuid, required
  - `destinationType` 'google_sheet' | 'clay_webhook' | 'slack' | 'webhook' | 'n8n' | 'notion' | 'pipedrive' | 'attio', required: Delivery channel type
  - `name` string, required
  - `config` object, required: Destination-specific configuration
  - `routing` union, required: When to auto-route signals to this destination. Defaults to {mode:"all"}.
    - object
      - `mode` 'all', required
    - object
      - `mode` 'manual', required
    - object
      - `mode` 'min_strength', required
      - `minStrength` integer, required
  - `isActive` boolean, required
  - `createdAt` string, date-time, required
  - `signatureSecret` string: HMAC secret used to sign outbound webhook deliveries (X-SignalRaven-Signature). Revealed once on create; rotate via POST :id/rotate-secret.

## Other responses

- `400`: Validation error

---

[API](https://skmtc.dev/signalraven/apis/zygnal-api.md) · [All operations](https://skmtc.dev/signalraven/apis/zygnal-api/llms.txt) · [OpenAPI document](https://skmtc.dev/signalraven/apis/zygnal-api/revisions/36e1d9b9d604?raw)