---
title: "Start Oauth"
method: GET
path: "/v1/pinterest/oauth/start"
tags: ["Pinterest"]
---

# Start Oauth

`GET /v1/pinterest/oauth/start`

## Request

- Base URL: `https://api.pinbridge.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.pinbridge.io/v1/pinterest/oauth/start`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Start Pinterest OAuth flow.

Returns authorization URL to redirect user to. Pass `account_id` when
reconnecting an account, so a workspace at its plan's account limit can still
reconnect it.

## Query parameters

- `account_id` string, uuid, nullable: When reconnecting, the connected account being reconnected. It does not count against the plan's Pinterest account limit.

## Headers

- `x-api-key` string, nullable
- `authorization` string, nullable

## Response `200`

Successful Response

- OAuthStartResponse: Response schema for OAuth start endpoint.
  - `authorization_url` string, uri, required

## Other responses

- `422`: Validation Error

---

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