---
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`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/oauth2/register`
- Auth: none required

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.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)