Exchange a public token Beta

Turn the token the hosted page returns into a durable connection

Beta. This endpoint is live for design partners, with keys that Dopl issues while the developer portal is being built.

POST /v1/connections/exchange

A public token exchanges once, within 30 minutes of the user finishing. Secret key, scope connect.

Authorizations

Authorizationrequiredheaderstring

A project secret key (sk_test_… or sk_live_…) sent as Authorization: Bearer <key>. Server to server only.

Idempotency-Keyheaderstring

Optional and accepted for consistency. This route does not replay responses.

Body

public_tokenrequiredstring

The public_token the hosted page added to your redirect_uri.

StatusBody
200ConnectionExchangeResponse
400, 401, 404Error