API - Plant A Tree With a Trigger on Your Software

How the API Works

1. Trigger Tree Planting – The API generates a unique Tree-Gift URL when triggered by a defined action.
2. Send the Gift – Choose to send the Tree-Gift email yourself or let Tree-Nation handle it.
3. Recipient Collects the Tree – The end user receives the tree and plants it in their own forest.
4. Data & Tracking – View tree counters, CO2 savings, and project updates in real-time.

Customizing the Experience

• Personalized Tree Messages – Use default messaging or create your own.
• Advanced Data Integration – Embed project updates, tree counters, and CO2 tracking into your software via RSS feeds.
• Corporate Client Profiles – Set up Tree-Nation profiles for your business clients and distribute planting credits to them.

The rest is handled on our platform.

With more advanced features, you can create a Tree-Nation user profile for your corporate clients. You can also manage and distribute credits to those clients, (contact us).

Level 1 - The API user

As an API user, your forest will be the SAAS platform that wants to include trees as a gamification mechanism within it. I.E: Offer a tree to every new employee, or to every client that reached certain points in a reward system.

Level 2 - End-Users

The end-users are the Tree-Gift recipients that are rewarded with them in function of their actions on the SAAS platform.

Tree creation

The main function of the API is to trigger/create a tree. When triggered, the API gives back a unique tree URL, which can be passed on to the end-user and serve as proof of planting and its own tree certificate.

Each URL redirects its recipient to your Tree-Nation forest to collect their Tree-Gift.

Communication with the recipient

If Tree-Nation is tasked to send the Tree-Gift emails, the recipient’s name and email can be passed through the API.

Each tree is linked to 2 forests: the corporate client forest (seen as the one gifting the tree) and the end-user forest (seen as the one receiving the tree).

• All the trees are thus visible in the SAAS platform forest.

• Each client has as many trees as they order, under your forest (the gifting company) and their forest as well (the recipient).

Forest information

The API also provides you with a series of content that can be directly included in the SAAS platform:

• Tree and CO2 counters for any given forest (the SAAS platform forest or the End-user forest).

• All project updates.

• All updates related to a single project.

• All updates related to a single forest (the SAAS platform forest, Corporate forest, or End-user forest).

Terms and Conditions of species selection

There are two ways to choose which tree species to plant via the API:

1. Selection by Price (Recommended)

• Choose from predefined species packages at fixed prices.
• Tree-Nation automatically selects species within your package.
• Ensures cost stability and hassle-free planting.

2. Selection by Species ID (Advanced)

• Specify a particular species using a Species ID.
• Prices may fluctuate over time based on species availability.
• Ideal for projects requiring specific tree species.
  💡 If using this option, always check the latest pricing via the API before planting.

To engage the first option and leverage a species package, simply omit the species_id from your API request's body. Doing so will prompt the system to default to the species package pre-configured in your account, which can be set using the form provided below, or adjusted through your Forest Success Manager.

Subscription

The API is a feature of our Pledge subscription:

• Basic API, with a Premium subscription
• Advanced API, with a Marketplace subscription

Getting Started with the API

1. Create a test account – Sign up on our test platform to experiment with API integration.
2. Request API access – Once ready, submit the form below to receive your API tokens. 
3. Review carefully the API documentation – Access our API guide on Postman.
4. Once you confirm test approval and are subscribed, the Live Token is shared to be able to move to production.  

For support, reach out to your Forest Success Manager.