Skip to main content

GraphQL Reference

The GraphQL API let you build apps and other integrations for Bettermode. This is a reference to every query, mutation, input, and object available in the Bettermode GraphQL API.

We highly recommend reading this guide to get started with Bettermode GraphQL API.


The GraphQL API requires a Bettermode access token for making authenticated requests.

You can obtain an access token either by following the App Access Token or Bettermode Access Token guide. Include the access token as an Authorization header in your requests as followed:

Authorization: Bearer {Access Token}

GraphQL Endpoint

The Bettermode GraphQL API is available at a single GraphQL endpoint:

You can access the GraphQL API playground here.


Bettermode's GraphQL APIs only accept POST requests. Other HTTP methods, such as GET or PUT, will return a 400 (Bad request) or 406 (Not acceptable) response.