---
title: "Begin the Pipedrive Connect flow"
method: POST
path: "/api/me/destinations/pipedrive/oauth/start"
tags: ["me"]
---

# Begin the Pipedrive Connect flow

`POST /api/me/destinations/pipedrive/oauth/start`

## Request

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

Mints a 10-min state JWT scoped to the calling customer and returns Pipedrive's authorize URL. After the customer approves, Pipedrive hits GET /api/destinations/pipedrive/oauth/callback which verifies the state, exchanges the code, and creates the destination.

## Response `200`

Authorize URL ready

- object
  - `authorizeUrl` string, uri, required

## Other responses

- `503`: Pipedrive OAuth not configured on this environment

---

[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)