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.

Authentication

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

https://api.bettermode.com

You can access the GraphQL API playground here.

info

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

https://api.bettermode.de

The GraphQL API playground for the EU region is available here.

note

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.