oAuth

Create Authorization

Authorizes another Organization to access your Inquiry, Verifications, or other Persona resources.

post/oauth/authorize

Request

  • Base URL: https://api.withpersona.com/api/v1
  • URL: https://api.withpersona.com/api/v1/oauth/authorize
  • Auth: HTTP bearer

Headers

Key-Inflection'camel' | 'kebab' | 'snake'

Determines casing for the API response.

Idempotency-Keystring

Ensures the request is idempotent.

Persona-Version'2026-09-29' | '2025-12-08' | '2025-10-27' | '2023-01-05' | '2022-09-01' | '2021-08-18' | '2021-07-05' | '2021-02-21' | '2020-05-18'

Server API version. More info on versioning can be found here.

Request body

client-idstring required

Organization (org_) to authorize

response-typestring required

Must be set to 'code'

scopestring required

Space-separated list of 'permission:object' combinations (i.e. inquiry.read:inq_uX7kRTiBxsJ1sZqPLAsjdP9j verification.read:ver_ynYuWdrjwwjiHJ2rgHfSoHeT

Response

This endpoint returns an Authorization Code.

codestring required

Authorization Code that is only usable by the Organization specified by the client-id

expires-ininteger required

Number of seconds until the authorization code expires.

Changes

No recorded changes to this operation across all 1 revision of this API.