Skip to content
English
  • There are no suggestions because the search field is empty.

API & Automation Overview

How to build climate action into your own products with the Ecologi API and app integrations.

You can fund climate impact automatically, or report your impact to your users in real time, using the Ecologi API and our no-code app integrations. It's all managed under Integrations in the left-hand menu, with the introductory and setup instructions provided in our detailed API docs.

The Integrations area

  • Usage - your API usage history, pending impact and total spending, filterable by year.
  • API keys - create and manage the access keys your integration uses.
  • Docs - the full API reference (also at docs.ecologi.com).
  • Recipient emails - manage the templated impact emails sent to recipients.
  • Apps - connect no-code integrations such as Shopify and Zapier.
  • Settings - manage your integration settings.

The two APIs

  • Impact API - fund trees, country-specific trees (UK, US, Australia and Brazil), carbon avoidance, carbon removals and habitat restoration. Requests are authenticated with your API key.
  • Reporting API - read your impact totals (trees funded, CO2e avoided and removed, and habitat restored). It's public, so no key is needed.

Getting started

  1. In the left-hand menu, select Integrations, open the API keys tab and generate a key.
  2. Read the API reference at docs.ecologi.com to find the endpoint you need.
  3. Send your first request, passing your key as a Bearer token in the Authorization header.

Support boundaries

We can help with:

  • Questions about your Ecologi account

  • Guidance on generating your API key

  • Issues with our API when used correctly

We can’t help with:

  • Writing or editing code

  • Troubleshooting Shopify, Zapier, or other third-party systems

  • Billing questions for third-party platforms

If you’re not confident in setting up an automation yourself, we recommend seeking help from a developer or the third-party platform’s support team.


FAQ

Can I fund impact automatically for every purchase or order?

Yes. On a Shopify store, use our Shopify app and choose your trigger (per order, per product, by basket spend, or a percentage of order value) to fund trees or carbon removals automatically. On another platform, use Zapier to trigger impact from an event such as a paid order. For full control, use the Custom API. Connect apps under Integrations - Apps, or see docs.ecologi.com.

I have no coding resource and don't want to use Shopify or Zapier - what can I do?

You can make manual, bulk purchases at any time through the Impact shop, and use the 'funded by' label on a tile (for example 'April orders') to represent a batch of customers. A minimum order currently applies to the general 'Tree planting around the world' product.

Can I choose the specific country or project my API funds?

The full list of API capabilities/countries and projects available can be found at https://docs.ecologi.com/

Can you build a custom API integration for me?

We can't build or troubleshoot custom integrations beyond providing our public API docs at docs.ecologi.com. You'll usually need a developer or technical partner to implement it.

What if I get stuck?

If the problem is with a correctly configured Ecologi API, your Ecologi account, or Ecologi-issued billing, contact us via the chatbot on our website. If it's with Shopify, Zapier or another third-party platform, contact their support directly.

What does the 'Pending' label on some of my impact mean?

Impact you fund through the API shows as pending until that month's payment is processed (usually at the start of the following month), when it's confirmed and the label is removed. Pending impact is already included in your totals and appears across the app and your public profile, marked with a clock icon. See 'API and integration pricing' for more.

Can I host my Ecologi forest on my own website?

Not directly. Share a link to your public Ecologi profile, or use the embeddable widgets and brand assets in the Sharing toolkit.

Can I add a purchase order (PO) number to my invoices? (Custom API only)

Yes, for Custom API users. Add your PO number under Integrations - Settings, and it will appear on your future Custom API invoices.