Skip to main content
POST
Initiate OAuth connection

Authorizations

Authorization
string
header
required

JWT token obtained through Barndoor's OAuth 2.0 authorization-code flow with PKCE.

The token should be included in the Authorization header: Authorization: Bearer <your-jwt-token>

Use the Barndoor SDK's loginInteractive() function to obtain tokens automatically.

Path Parameters

server_id
string<uuid>
required

Server UUID

Query Parameters

return_url
string<uri>

Optional return URL after OAuth completion

Body

application/json

The body is of type object.

Response

Connection initiation successful

auth_url
string<uri>

OAuth authorization URL to redirect user to

Example:

"https://login.salesforce.com/services/oauth2/authorize?..."