Skip to main content
POST
Register OAuth client

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
redirect_uris
string<uri>[]
required

Array of redirect URIs for the client. HTTPS, localhost, and supported native app callback URIs are accepted.

Minimum array length: 1
Example:
client_name
string

Human-readable name of the client.

Example:

"Claude Desktop"

client_uri
string<uri>

URL of the client's home page.

logo_uri
string<uri>

URL of the client's logo.

scope
string

Space-separated list of requested scopes.

Example:

"read write"

grant_types
enum<string>[]

Grant types the client will use.

Available options:
authorization_code,
refresh_token
Example:
response_types
enum<string>[]

Response types the client will use.

Available options:
code
Example:
token_endpoint_auth_method
enum<string>

Authentication method for token endpoint. All clients are treated as public (no secret issued).

Available options:
none,
client_secret_post
software_id
string

Unique identifier for the client software.

software_version
string

Version of the client software.

contacts
string<email>[]

Contact emails for the client developers.

tos_uri
string<uri>

URL to the client's terms of service.

policy_uri
string<uri>

URL to the client's privacy policy.

Response

client_id
string
required

Unique client identifier.

Example:

"dyn_abc123xyz789"

client_id_issued_at
number
required

Unix timestamp when client_id was issued.

redirect_uris
string[]
required

Registered redirect URIs.

grant_types
string[]
required

Grant types the client can use.

response_types
string[]
required

Response types the client can use.

token_endpoint_auth_method
enum<string>
required

Authentication method for token endpoint.

Available options:
none,
client_secret_post
client_name
string

Human-readable name of the client.

client_uri
string

URL of the client's home page.

logo_uri
string

URL of the client's logo.

scope
string

Space-separated list of granted scopes.