In this article:
- An Introduction to GraphQL
- API Versioning
- Apollo Explorer IDE Interface
- Authorization with GraphQL
- Other Helpful Articles
An Introduction to GraphQL
Thinkific's GraphQL API was introduced in April 2024. We will continue to support our existing REST API as is for the foreseeable future, but all new development will occur in GraphQL only going forward.
If you’re unfamiliar with GraphQL as a technology, we recommend the following introductory resources which cover common patterns and concepts of GraphQL (as there are important differences from REST APIs):
- https://graphql.org/learn/
- https://www.apollographql.com/blog/graphql/basics/what-is-graphql-introduction/
- https://hygraph.com/academy/what-is-graphql
You can use our Explorer app to easily review what data we expose through our GraphQL API and to test queries (returning your site's data).
API Versioning
Thinkific's GraphQL API uses two distinct endpoints, each of which is used for versions of varying maturity:
- The Stable API endpoint at https://api.thinkific.com/stable/graphql
- The Beta API endpoint at https://api.thinkific.com/beta/graphql
Our Stable API is our production GraphQL API. Use this endpoint to build core integrations that are live on your platform. Any breaking changes to this endpoint will go through proper communication, giving you time to adapt and make any required changes to your app.
Our Beta API provides our developers with a preview of upcoming GraphQL features so that they can gain familiarity and develop in anticipation of these features moving to a stable state. As it is a Beta, please note that we may introduce breaking changes without warning.
NOTE: Thinkific will deny acceptance to the Thinkific App Store to public apps that make requests to the `/beta/graphql` endpoint during the app listing review process. If your app relies on Beta API data, please contact us, and we'll work with you to time your submissions based on our development timelines.
Apollo Explorer IDE Interface
Apollo Explorer is an integrated GraphQL development environment (IDE) that allows you to build, test, and explore queries and mutations on a Thinkific account. To access Explorer for Thinkific:
- Click this link
- Click Explorer on the left sidebar
- When you submit your first request, enter your Thinkific account's subdomain
- Authenticate the Apollo Explorer app
- Start building queries and mutations!
Explorer's schema tab provides a comprehensive guide to available queries, mutations, types, fields, and more.
Authorization with GraphQL
Thinkific's GraphQL API uses two different authorization methods:
- Use the API Access Token Authorization method for private applications intended only for your own use.
- Use the OAuth Authorization method for public applications intended for use on the Thinkific App Store.
NOTE: GraphQL cannot be accessed using API Key Authorization.
Other Helpful Articles
For further information about Thinkific's GraphQL API, here are some additional resources that may be valuable for you: