VocalDocscontracts 1.65.0

ConnectionAuthorization

The answer of POST /v1/connections/{connection_id}/authorize (1.60.0; integrations.md section 7): where to send the Member's browser. The vendor redirects to the edge role's callback, which completes the exchange.

An object with 5 fields.

Fields

FieldTypeRequiredDescription
authorization_urlstring (uri)yesThe vendor's authorization URL with PKCE (S256), the single-use state and the requested scopes, to open in the Member's browser.
connection_idConnectionIdyes
expires_atTimestampyesWhen the state stops being accepted: 10 minutes after issue (a target).
object"connection_authorization"yes
scopesarray of VendorScopeyes

Used by

The operations whose parameters, request body or responses name this shape directly.