Getting started

The ekko Climate API is designed to be quick to set up and easy to test. In just a few steps, you can create an account, get your keys, and make your first call.

Step 1: Access ekko Hub

When you start an integration with ekko, you’ll get an invite to our sandbox ekko Hub, where you can create an API key (amongst other things). After setting up multi-factor authentication (MFA), you’ll be ready to log in and create your first API key.

For more information on what you can do in ekko Hub, see the ekko Hub overview.

Step 2: Create your API key

Log in to ekko Hub (sandbox)
Navigate to the Developer Console
Generate a new API key (keep it safe - it authenticates all your API calls)

Your API key must be passed in the X-Api-Key header on every request.

⚠️
Never expose your API key in public code or repositories.

Step 3: Pick a path & run your first flow

Choose the integration path that fits your journey, then follow the steps on the matching page.

Step 4: Explore the sandbox

Use the sandbox to try out different scenarios:

Simulate purchases with varying amounts and merchants
Trigger contributions and reversals
Test SDK flows before you go live

When you’re ready, we’ll guide you through the go‑live checklist to move to production.