Skip to main content

GraphQL API Reference (v1)

Welcome to the Massdriver GraphQL v1 API documentation. The v1 API provides a streamlined interface with improved consistency and pagination patterns.

Getting Started​

To use the Massdriver GraphQL v1 API, you'll need to:

  1. Authenticate with your API credentials (see below)
  2. Send requests to the v1 GraphQL endpoint
  3. Use the queries and mutations documented below

API Endpoint​

The v1 GraphQL API is available at: https://api.massdriver.cloud/api/graphql/v1

Authentication​

All API requests require authentication using a service account key. You'll need to create a service account and obtain a key. Learn more about service accounts here.

Authorization header format:

Authorization: Basic BASE64ENCODED(org_slug:service_account.secret)

Replace org_slug and service_account.secret with your actual organization slug and service account secret.

GraphQL Playground​

You can explore and test the v1 API using the GraphQL Playground. This playground uses your logged-in user session and does not require a service account key.