App Authentication

Do not require authentication:

Do require authentication:

Authenticated Patch API endpoints use OAuth 2.0 methods to authenticate requests.

Get Started

  1. On Discord, request a client_id and client_secret

  2. Request a Bearer token via the /v1/auth endpoint

  3. Provide the Bearer token in the Authorization header

1) Get a client_id and client_secret

On Discord request a client_id and client_secret to access the service.

2) Request a Bearer token

Use the script below to get a Bearer token for your client_id and client_secret.

var myHeaders = new Headers();
myHeaders.append("Content-Type", "application/x-www-form-urlencoded");

var urlencoded = new URLSearchParams();
urlencoded.append("client_id", "demo-user-external");
urlencoded.append("client_secret", "k^yf57yg27MKo2SnuzwX");

var requestOptions = {
  method: 'POST',
  headers: myHeaders,
  body: urlencoded,
  redirect: 'follow'

fetch("", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

3) Call endpoints with Bearer token

API requests are authenticated using the Bearer Auth scheme. To authenticate a request, provide the Bearer token in the Authorization header of the request:

curl -H "Authorization: Bearer <your_bearer_token>"

Bearer tokens expire every 60 minutes so a new one needs to be generated.

Last updated