Skip to main content
The API playground lets you explore the ION GraphQL schema and run queries against your tenant before you write client code. Access it by going to Developer Platform > GraphQL on the sidebar.

​
Authenticate

To run a query, first set your access token in the Authorization header field at the top of the playground:
There are two ways to get a token:
  • API key: exchange it for a token through your auth provider’s client-credentials grant. See Manage API keys.
  • OAuth 2.0: complete the authorization code flow and use the resulting access token. See Authenticate with OAuth 2.0.
The playground stores tokens locally in your browser and sends them only to the ION API.

​
Quick start

Run this query first to confirm your token works:
A successful response means your token is valid for the tenant in organization.domain. If you get an errors[] payload instead, see Error codes.

​
What you can do here

The playground runs mutations against the live API. Use a sandbox tenant when prototyping mutations so you don’t change production data.
  • Schema explorer: click any type to see its fields, arguments, and return types.
  • Variables panel: pass query variables as JSON instead of hardcoding them in the query body.
  • History: the playground saves every query you run locally. Re-run or share a saved query with teammates.
  • Schema docs sidebar: type __schema or __type to run an introspection query and inspect the schema.

​
Example Queries and Mutations

See Example requests.

​
GraphQL schema reference

For every query, mutation, and type in the schema, see the API Reference.
To find which query or mutation powers a page, open your browser’s developer tools, go to the Network tab, and click around in ION. The app shows the exact queries, mutations, and filters it sends.