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 Authentication or Member Authentication 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 the following GraphQL endpoint for the US region (us-east-1):

You can access the GraphQL API playground here.


If your community is in the EU region (eu-central-1), you should use the following GraphQL endpoint instead:

The GraphQL API playground for the EU region is available 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.