Oauth token

POST /oauth/token

Exchange client credentials for a token

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

grant_type?string

OAuth2 grant type. Required. The handler accepts only client_credentials; any other value returns 400 unsupported_grant_type.

client_id?string

Public client identifier. Required. Format: p3_<32-hex>. Issued at client creation; safe to embed in source.

client_secret?string

Client secret. Required. 32 random bytes, base64url-encoded (~43 chars). Returned ONLY at client creation / rotation — Part3 stores a SHA-256 hash and cannot recover the plaintext. Treat as a credential.

[key: string]?any

Response Body

`application/json`

curl -X POST "https://api.part3.io/v1/oauth/token" \  -H "Content-Type: application/json" \  -d '{}'

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiI0ZjVlNmQ3Yy04YjlhLTRkMmUtYTNmNS02NzhjOWQwZTFmMmEiLCJ0eXBlIjoiY2xpZW50IiwiaWF0IjoxNzYxOTQ4MDAwLCJleHAiOjE3NjE5NTE2MDB9.signed",
  "token_type": "Bearer",
  "expires_in": 3600
}

{
  "error": "invalid_client",
  "error_description": "Invalid client credentials"
}

{
  "error": "invalid_client",
  "error_description": "Invalid client credentials"
}

{
  "error": "invalid_client",
  "error_description": "Invalid client credentials"
}

{
  "error": "invalid_client",
  "error_description": "Invalid client credentials"
}

Oauth token

Request Body

Response Body

200application/json

400application/json

401application/json

403application/json

429application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`