Sign in

v51

latestOpenAPI 3.0.0Apache 2.0raw.githubusercontent.com2026-08-011534301009.2 KB
Apps

Install app via OAuth2

Authorize OAuth2 code. Verifies the OAuth code and exchanges it for a token and refresh token

get/api/v1/marketplace/listings/{type}/install/oauth2/authorize

Path parameters

type'stripe' | 'sandbox' | 'custom_invoicing' required

Type of the app.

The type of the app to install.

Query parameters

statestring

Required if the "state" parameter was present in the client authorization request. The exact value received from the client:

Unique, randomly generated, opaque, and non-guessable string that is sent when starting an authentication request and validated when processing the response.

codestring

Authorization code which the client will later exchange for an access token. Required with the success response.

error'invalid_request' | 'unauthorized_client' | 'access_denied' | 'unsupported_response_type' | 'invalid_scope' | 'server_error' | 'temporarily_unavailable'

OAuth2 authorization code grant error types.

Error code. Required with the error response.

error_descriptionstring

Optional human-readable text providing additional information, used to assist the client developer in understanding the error that occurred.

error_uristring

Optional uri identifying a human-readable web page with information about the error, used to provide the client developer with additional information about the error

Response

An unexpected error response.