---
title: "Register an OAuth2 client"
method: POST
path: "/api/v2/oauth2/register"
tags: ["OAuth2 Client Public"]
---

# Register an OAuth2 client

`POST /api/v2/oauth2/register`

Register an OAuth2 client using the Dynamic Client Registration protocol defined in RFC 7591.

## Request body

- OAuthClientRegistrationRequest — Request payload for OAuth2 dynamic client registration as defined by RFC 7591.
  - `client_name` string, required — Human-readable name of the client. Control characters are rejected.
  - `client_uri` string — URL of the home page of the client.
  - `grant_types` OAuthClientRegistrationGrantType[] — 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` string[], required — Array of redirection URI strings used by the client in redirect-based flows.
  - `response_types` OAuthClientRegistrationResponseType[] — 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.

## Response `201`

Created

- OAuthClientRegistrationResponse — Response payload for a successful OAuth2 dynamic client registration as defined by RFC 7591.
  - `client_id` string, uuid, required — Unique identifier assigned to the registered client.
  - `client_name` string, required — Human-readable name of the client.
  - `grant_types` OAuthClientRegistrationGrantType[], required — OAuth 2.0 grant types registered for the client.
  - `redirect_uris` string[], required — Redirection URIs registered for the client.
  - `response_types` OAuthClientRegistrationResponseType[], required — OAuth 2.0 response types registered for the client.
  - `token_endpoint_auth_method` string, required — Authentication method registered for the token endpoint. Always `none`.

## Other responses

- `400` — Bad Request
- `429` — Too many requests

---

[API](https://skmtc.net/datadog/apis/api-v2.md) · [All operations](https://skmtc.net/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v2/revisions/da68bf029e4c/schema)