---
title: "OAuth 2.0 client registration"
method: POST
path: "/oauth2/registerclient_23X_v1"
---

# OAuth 2.0 client registration

`POST /oauth2/registerclient_23X_v1`

Create an account for a third-party application

## Request body

- object
  - `name` string, required — The name of the application account.
  - `description` string — A description of the application account.
  - `iconID` string — The <a href="https://orangedam.readme.io/docs/assets#record-id">record ID</a> of an asset in Orange Logic.<br></br>Choose an image file, such as a logo, to identify the account. An account icon image is not required, but we recommend using one because users see this image when they authorize the third-party application.
  - `redirectURIs` string, required — The URL the user is redirected to after authorizing the application.<br></br>A redirect URI is often the home page or login page of the third-party application. Check the API documentation of the third-party application to find a recommended URI redirect address.
  - `seed` string — A unique value that allows any new accounts created with the same name and seed to generate the same OAuth credentials.<br></br>Seeds are optional. However, we strongly recommend using them to simplify your configuration by creating consistent credentials across environments or sites. You can enter any string, but we recommend including the account name. Keep seeds confidential and document their purpose clearly to simplify future account management.
  - `groups` string — A list of the <a href="https://link.orangelogic.com/CMS4/Permalinks/2P7YOHDZQUNL" target="_blank">groups</a> the application account is assigned to.

## Response `200`

200

- object
  - `info` object
    - `id` string
    - `name` string
    - `description` string
    - `iconID` string
    - `redirectURIs` string[]
  - `credentials` object
    - `id` string
    - `secret` string

---

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