Skip to main content

Prerequisites

  • A Hey Chocolate account with an API key (sign up here)
  • A tool to make GraphQL requests (cURL, Postman, or any GraphQL client)

Step 1: Get your API key

Navigate to the Dashboard and create a new API key under Settings > API Keys.
Keep your API key secret. Never expose it in client-side code. Use server-side requests or a backend proxy.

Step 2: Make your first query

Send a GraphQL request to the Hey Chocolate API endpoint:
Response:

Step 3: Calculate an impact score

Use the calculateImpact mutation to compute a real-time sustainability score:
Response:

Step 4: Explore further

Core Concepts

Learn about calculators, scenarios, and the equivalency engine.

SDKs & Widgets

Drop in pre-built components for instant sustainability features.

Compliance

Generate Digital Product Passports and EPD reports.

Full API Reference

Explore every query, mutation, and type in the GraphQL schema.