Skip to main content
POST
Create authorization request
  • Creates a new authorization request for headless OAuth flows
  • Returns a popup URL that users can visit to complete identity verification
  • Requires Bearer token authentication with your program API key
  • Authorization requests expire after 15 minutes

Authorizations

Authorization
string
header
required

Program API key obtained from the admin dashboard

Response

Authorization request created successfully

auth_id
string<uuid>
required

Unique identifier for this authorization request

popup_url
string<uri>
required

URL for the user to visit in a popup window to complete authorization

status
enum<string>
required

Current status of the authorization request

Available options:
pending
expires_at
string<date-time>
required

When this authorization request expires (15 minutes from creation)