Register an OAuth2 client

v2 (latest)

Note: This endpoint is in preview and is subject to change. If you have any feedback, contact Datadog support.

POST https://api.ap1.datadoghq.com/api/v2/oauth2/registerhttps://api.ap2.datadoghq.com/api/v2/oauth2/registerhttps://api.datadoghq.eu/api/v2/oauth2/registerhttps://api.ddog-gov.com/api/v2/oauth2/registerhttps://api.us2.ddog-gov.com/api/v2/oauth2/registerhttps://api.datadoghq.com/api/v2/oauth2/registerhttps://api.us3.datadoghq.com/api/v2/oauth2/registerhttps://api.us5.datadoghq.com/api/v2/oauth2/register

Overview

Request

Body Data (required)

Expand All

Field

Type

Description

client_name [required]

string

Human-readable name of the client. Control characters are rejected.

client_uri

string

URL of the home page of the client.

grant_types

[string]

OAuth 2.0 grant types the client may use. Defaults to authorization_code and refresh_token when omitted.

jwks_uri

string

URL referencing the client's JSON Web Key Set.

logo_uri

string

URL referencing a logo for the client.

policy_uri

string

URL pointing to the client's privacy policy.

redirect_uris [required]

[string]

Array of redirection URI strings used by the client in redirect-based flows.

response_types

[string]

OAuth 2.0 response types the client may use. Only code is supported.

scope

string

Space-separated list of scope values the client may request.

token_endpoint_auth_method

string

Requested authentication method for the token endpoint. Only none is supported.

tos_uri

string

URL pointing to the client's terms of service.

{
  "client_name": "Example MCP Client",
  "client_uri": "https://example.com",
  "grant_types": [
    "authorization_code",
    "refresh_token"
  ],
  "jwks_uri": "https://example.com/.well-known/jwks.json",
  "logo_uri": "https://example.com/logo.png",
  "policy_uri": "https://example.com/privacy",
  "redirect_uris": [
    "https://example.com/oauth/callback"
  ],
  "response_types": [
    "code"
  ],
  "scope": "openid profile",
  "token_endpoint_auth_method": "none",
  "tos_uri": "https://example.com/tos"
}

Response

Created

Response payload for a successful OAuth2 dynamic client registration as defined by RFC 7591.

Expand All

Field

Type

Description

client_id [required]

uuid

Unique identifier assigned to the registered client.

client_name [required]

string

Human-readable name of the client.

grant_types [required]

[string]

OAuth 2.0 grant types registered for the client.

redirect_uris [required]

[string]

Redirection URIs registered for the client.

response_types [required]

[string]

OAuth 2.0 response types registered for the client.

token_endpoint_auth_method [required]

string

Authentication method registered for the token endpoint. Always none.

{
  "client_id": "72b68208-36a6-11f0-b21b-da7ad0900002",
  "client_name": "Example MCP Client",
  "grant_types": [
    "authorization_code",
    "refresh_token"
  ],
  "redirect_uris": [
    "https://example.com/oauth/callback"
  ],
  "response_types": [
    "code"
  ],
  "token_endpoint_auth_method": "none"
}

Bad Request

Error payload returned by OAuth2 dynamic client registration as defined by RFC 7591.

Expand All

Field

Type

Description

error [required]

string

Single ASCII error code per RFC 7591, such as invalid_request or invalid_client_metadata.

error_description [required]

string

Human-readable description of the error.

{
  "error": "invalid_client_metadata",
  "error_description": "redirect URI is not well-formed"
}

Too many requests

API error response.

Expand All

Field

Type

Description

errors [required]

[string]

A list of errors.

{
  "errors": [
    "Bad Request"
  ]
}

Code Example

                  ## default
# 

# Curl command
curl -X POST "https://api.ap1.datadoghq.com"https://api.ap2.datadoghq.com"https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.us2.ddog-gov.com"https://api.datadoghq.com"https://api.us3.datadoghq.com"https://api.us5.datadoghq.com/api/v2/oauth2/register" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d @- << EOF
{
  "client_name": "Example MCP Client",
  "grant_types": [
    "authorization_code",
    "refresh_token"
  ],
  "redirect_uris": [
    "https://example.com/oauth/callback"
  ],
  "response_types": [
    "code"
  ],
  "token_endpoint_auth_method": "none"
}
EOF

                

Register an OAuth2 client

Overview

Request

Body Data (required)

Response

Code Example

Register an OAuth2 client

How can I help you today?