App Authentication

Do not require authentication:
Do require authentication:
Authenticated Patch API endpoints use OAuth 2.0 methods to authenticate requests.
Get Started
  1. 1.
    On Discord, request a client_id and client_secret
  2. 2.
    Request a Bearer token via the /v1/auth endpoint
  3. 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.