Ecologi
Utilities & PersonalConnect AI agents to Ecologi, a UK climate action service funding tree planting and carbon removal. Agents purchase climate impact as a step inside a flow and pull the reporting that evidences it.
What This Integration Enables
Ecologi is a climate action service, and this connector is a spend action wearing an environmental label. That is not a criticism, it is the design constraint everything else follows from. Ecologi is candid that every purchasing call creates a real, paid order against your account, that there is no cancel or refund endpoint, and that the only safe rehearsal is the Test Mode toggle, which validates a request without funding impact or being charged. Any flow that treats these as ordinary API calls will eventually charge twice for the same event and have no way to unwind it.
The connector has two halves living on one host, and they have different rules. The reporting half is five actions, all public, none of them requiring an API key: Get Trees Funded, Get Carbon Offset, Get Carbon Removal, Get Habitat Restored, and Get Impact Summary each read a public Ecologi user's totals, along with the pending amounts that are funded but not yet fully actioned. The username is the handle from a public impact profile at ecologi.com followed by the username, and because the reads are unauthenticated they can report on any public profile, not only your own. Trees are counts, carbon offset and removal are tonnes of CO2e, and habitat restoration is square meters. The purchasing half is five actions and requires a key sent as a Bearer token: Plant Trees funds reforestation and returns the amount charged, the currency, a shareable tree URL, and a per-project split of where the trees went; Plant Local Trees does the same restricted to the United Kingdom, United States, Australia, or Brazil; Offset Carbon buys carbon avoidance credits in kilograms or tonnes; Remove Carbon buys permanent removal in whole kilograms; and Restore Habitat funds ecosystem restoration in square meters. Ecologi publishes no event subscription, so this service ships no triggers. A flow funds impact from a business event another system raised, or reads totals on a schedule for reporting, and nothing here ever calls back.
One asymmetry deserves emphasis before any of it is automated. Plant Trees accepts an optional Idempotency Key, sent as the Idempotency-Key header, and reusing the same key prevents a duplicate charge on a retry. Ecologi documents this for Plant Trees only. Plant Local Trees, Offset Carbon, Remove Carbon, and Restore Habitat have no such protection, so on those four a retried request is a second real charge with no endpoint that can take it back.
Without FlowRunner
With FlowRunner
Use Case Scenarios
Emissions read from a meter rather than estimated in a spreadsheet
A company wants to offset the electricity it actually used rather than a figure someone modeled. On a monthly schedule the agent calls Octopus Energy Summarize Electricity Consumption for the period, which returns total kWh along with the number of intervals read. That interval count is doing real work: consumption readings arrive a day or so after the fact, so a run on the first of the month is reading an incomplete final day, and the agent uses the interval count to confirm the window is whole before it converts anything into an emissions figure. It then calls Offset Carbon in Test Mode to obtain the quoted amount and currency, posts both to finance, and funds the live purchase only after approval. The returned shareable tile URL and funded project details go into Google Sheets alongside the kWh they came from, so the claim is traceable back to a meter reading rather than to a rounding decision.
A tree per order, without a tree per retry
An ecommerce team wants to fund a tree for every qualifying order. When Shopify reports one, the agent calls Plant Trees with an Idempotency Key derived from the order number. This is the only purchasing action on the connector that supports it, and using it turns an at-least-once delivery model into a safe one: a flow that retries after a timeout sends the same key and does not charge again. The response carries the amount charged, the currency, a shareable tree URL, and the per-project split, and the agent sends the customer their tree page through Gmail. Where the same team wants to fund local trees instead, the flow changes shape rather than just changing the action, because Plant Local Trees has no idempotency key and needs its own duplicate guard held in the flow's own state.
Reporting that reads the source instead of quoting a slide
A customer asks what a supplier's environmental claims are actually backed by. On a schedule the agent calls Get Impact Summary, which returns trees, carbon offset, carbon removal, and habitat restoration together, each with its pending amount. It writes the figures to Google Sheets and posts a monthly line to Slack. Because these five reads are public and need no key, the same flow can report on a partner's or a supplier's public profile without holding any credential for them, which is a genuinely unusual property in a reporting API. Pending amounts are reported separately rather than folded into the headline, since impact funded and impact actioned are different claims.
Human-in-Loop Highlight
Ecologi's own documentation contains the sentence that decides where the gate goes: purchases are not reversible via the API, and there is no cancel or refund endpoint. Compare that to almost anything else a flow touches. A wrong record is updated, a wrong message is deleted, a wrong order is cancelled. Here, a single call to Offset Carbon with the units field set to Tonnes when the flow computed kilograms is a purchase a thousand times larger than intended, it succeeds, it is charged, and there is no second call that undoes it. The unit fields across these five actions are exactly where that error lives: Offset Carbon takes Kilograms or Tonnes, Remove Carbon takes a whole number of kilograms with a minimum of 1, Restore Habitat takes square meters to one decimal place with a minimum of 0.1, and Plant Trees takes a whole number of trees between 1 and 250,000. Four different units, one connector, and no way back. So the agent uses the vendor's own dry run as the gate rather than as a testing convenience. Every purchasing flow runs the intended call with Test Mode enabled first, which validates the request and returns the shape of what would happen without funding anything or being charged, and posts the result to the person who owns the budget in Slack: "Monthly carbon offset for July. Metered electricity consumption was 18,400 kWh across 1,488 half hourly intervals, a complete month. That converts to 3,240 kg CO2e under the factor in the policy sheet. Test Mode on Offset Carbon with units Kilograms quotes 41.60 GBP. Ecologi has no refund endpoint and Offset Carbon has no idempotency key, so if this runs twice it is charged twice and I cannot reverse either one. Approve the live purchase, adjust the amount, or hold for the corrected factor?" A person answers, and the agent makes exactly one live call. Plant Trees is the one action where a standing per-order authorization is defensible without a human on each purchase, precisely because its Idempotency Key removes the duplicate-charge failure and the per-unit amount is small and bounded. The other four sit behind a person on every run, or behind a hard periodic cap the flow enforces itself. This is human-in-the-loop orchestration applied to the plainest case there is: an irreversible outbound payment on a connector that publishes no way to take it back.
Agent Capabilities
10 actionsImpact Reporting
5- Get Trees Funded Returns the total number of trees a public Ecologi user has funded, plus any trees still pending planting. A public reporting endpoint that needs no API key. The username is the handle in the user's public impact profile at ecologi.com followed by the username.
- Get Carbon Offset Returns the total CO2e (carbon avoided) a public Ecologi user has funded, plus any pending amount, measured in tonnes of CO2e. Public and unauthenticated.
- Get Carbon Removal Returns the total CO2e permanently removed that a public Ecologi user has funded, plus any pending amount, measured in tonnes of CO2e. Permanent removal and carbon avoidance are different claims and are reported separately here for that reason. Public and unauthenticated.
- Get Habitat Restored Returns the total habitat area a public Ecologi user has funded for restoration, plus any pending amount, measured in square meters. Public and unauthenticated.
- Get Impact Summary Returns a combined view of all impact a public Ecologi user has funded, including trees, carbon offset, carbon removal, and habitat restoration, each with its pending amount. The right single call for a periodic report. Public and unauthenticated.
Funding Impact
5- Plant Trees Funds the planting of trees through Ecologi's reforestation projects and returns the amount charged, the currency, a shareable tree URL, and a per-project split of where the trees were planted. Requires an API key. The number of trees must be a whole number between 1 and 250,000. Set Test Mode to validate a request without funding real trees or being charged. This is the only purchasing action that accepts an Idempotency Key, which prevents a duplicate charge on a retry.
- Plant Local Trees Funds reforestation local to a specific country (United Kingdom, United States, Australia, or Brazil) and returns the amount charged, the currency, a shareable tree URL, and a per-project split. Requires an API key. Test Mode validates without charging. No idempotency key, so a retry is a second real charge.
- Offset Carbon Purchases carbon avoidance credits in kilograms or tonnes and returns the amount charged, the currency, the number of tonnes offset, a shareable tile URL, and the funded project details. Requires an API key. Test Mode validates without charging. The Kilograms and Tonnes selector is the field most worth a second pair of eyes.
- Remove Carbon Purchases permanent carbon removal, measured in kilograms, and returns the funded project details along with the amount charged. Requires an API key. The amount must be a whole number of kilograms, minimum 1. Test Mode validates without charging.
- Restore Habitat Funds habitat and ecosystem restoration, measured in square meters, and returns the funded project details along with the amount charged. Requires an API key. The area accepts up to one decimal place, minimum 0.1. Test Mode validates without charging.
Frequently Asked Questions
What can FlowRunner do with Ecologi?
FlowRunner agents can run Get Trees Funded, Get Carbon Offset, and Get Carbon Removal in Ecologi, plus 7 more actions.
Does connecting Ecologi to FlowRunner require OAuth?
No. Ecologi connects to FlowRunner with an API key, no OAuth flow required.
Can Ecologi trigger a FlowRunner workflow automatically?
Ecologi doesn't currently expose triggers in FlowRunner. It connects as an action step inside workflows started by another trigger.
Start building with Ecologi
$100 in credits. No card required. Connect in minutes.