Create OAuth App

URLRequires AuthHTTP Method

/api/v1/oauth-apps.create

POST

Permission required: manage-oauth-apps

Body Parameters

KeyExample ValueDescription

name*

test-oauth-app

The app name that you want to create.

active*

true

Whether the app will be active or not. Enter a boolean value, true or false..

redirectUri*

https://testuri.com

The URL to redirect the OAuth app.

Example Call

curl 'http://localhost:3000/api/v1/oauth-apps.create' \
  -H 'Content-Type: application/json' \
  -H 'X-Auth-Token: G1xiui60uWU3A2sRuv0seG3zVKpphJls3NuXVFNDH_o' \
  -H 'X-User-Id: YA5aSHTjZNJEGKHhK' \
  --data-raw '{
        "name": "test-oauth-app",
        "redirectUri": "https://testuri.com",
        "active": true }'

Example Response

{
  "application": {
    "name": "test-oauth-app",
    "redirectUri": "https://testuri.com",
    "active": true,
    "clientId": "bN9D5TjY8Cv8GqWfE",
    "clientSecret": "l3HAl0lSr2VaTYZVED6EabyhNzovS8Je2JYmbjNT-V1",
    "_createdAt": "2024-01-17T13:30:41.521Z",
    "_updatedAt": "2024-01-17T13:30:41.521Z",
    "_createdBy": {
      "_id": "JFTcMhEAFbNPfnp49",
      "username": "math.bar"
    },
    "_id": "65a7d68142a7e12453052d56"
  },
  "success": true
}

Last updated

Rocket.Chat versions receive support for six months after release.