POST/oauth/token

Token endpoint

Requires Bearer authentication. See Authentication.

Request body

Field	Type	Description
`grant_type`required	"authorization_code" \| "refresh_token" \| "urn:ietf:params:oauth:grant-type:device_code"	—
`code`	string	—
`code_verifier`	string	—
`redirect_uri`	string	—
`refresh_token`	string	—
`device_code`	string	—
`client_id`required	string	—
`resource`	string	—

Responses

200 200

Field	Type	Description
`access_token`required	string	—
`token_type`required	"Bearer"	—
`expires_in`required	number	—
`refresh_token`	string	—
`scope`required	string	—

400 400

Field	Type	Description
`error`required	string	—
`error_description`	string	—

Errors

Errors use the standard envelope. See Errors for codes, status mappings, and retry semantics.

Request

curl -X POST https://api.pushrail.io/oauth/token \
  -H "Authorization: Bearer pk_live_..." \
  -H "Content-Type: application/json" \
  -d '  {
    "grant_type": "authorization_code",
    "code": "string",
    "code_verifier": "string",
    "redirect_uri": "string",
    "refresh_token": "string",
    "device_code": "string",
    "client_id": "string",
    "resource": "string"
  }'

Response · 200200

{
  "access_token": "string",
  "token_type": "Bearer",
  "expires_in": 0,
  "refresh_token": "string",
  "scope": "string"
}

Response · 400400

{
  "error": "string",
  "error_description": "string"
}