Skip to main content
POST
/
oauth
/
connect
/
session
Create OAuth Connect Session
curl --request POST \
  --url https://api.veryfront.com/oauth/connect/session \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "integration": "<string>",
  "redirect_uri": "<string>",
  "projectId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'
{
  "session_token": "<string>",
  "connect_url": "<string>"
}

Authorizations

​
Authorization
string
header
required

Use a JWT bearer token or a Veryfront API key in the Authorization header.

Body

application/json
​
integration
string
required

Integration identifier to connect, for example github or slack.

​
redirect_uri
string
required

Validated native or web redirect URI after OAuth completes.

​
projectId
string<uuid>

Project ID to connect; omit for user-level OAuth.

Response

200 - application/json

OAuth connect session created

​
session_token
string
required

One-time OAuth connect session token for native app handoff.

​
connect_url
string
required

OAuth connect URL that starts the provider consent flow.