Our API empowers you to automate the process of gifting trees to your customers through specific actions on your website or software. This feature stands as our most robust tool, offering unparalleled flexibility and customization
What the API does
Our API provides the capability to plant and gift trees in response to any action. It enables customization in terms of selecting the project, species, and the option to receive a URL for the Tree-Gift. This URL allows the recipient to engage in the planting process on our platform. Additionally, you have the choice to delegate the task of sending the Tree-Gift email containing the URL, either through Tree-Nation or personally.
Furthermore, our API offers the flexibility to use a default tree message or craft unique ones.
Included in our API package are RSS feeds, allowing you to gather information about specific projects or your forest. These feeds can be directly integrated into your software for seamless content management.
The operational aspects beyond these functionalities are efficiently managed on our platform.
With more advanced features, you can create a Tree-Nation user profile for your corporate clients. You can also manage and allocate 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.
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 his forest as well (the recipient).
To pay for the trees it is defined that:
- Tree-Nation would only be invoicing the API user, not its Tree-Gift recipients. This allows avoiding additional approval processes from the clients to receive the gift at Tree-Nation.
- The API user has to credit his account in advance through the platform in order to pay for the client's Tree-Gifts. You may also opt in monthly invoices.
Let's see an example:
Your company credits it's account with 1000€ (1000 tree credit). Then your end user subscribes or makes a purchase through your platform (you make the decision of what triggers a Tree-Gift). With that action, your client/employee receives a Tree-Gift from your company, and the tree price is deducted from your 1000€ credits.
Invoices are paid by bank transfer. The period to pay the invoices can be adjusted to fit your company.
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 methodologies for selecting tree species for planting:
Selection by Price (Recommended): This user-friendly option allows for planting through predefined species packages, each anchored to a specific price point. The composition of species within these packages is dynamically managed by Tree-Nation and may vary periodically to align with the predetermined price. Opting for this method ensures cost stability and simplifies the selection process.
- Selection by Species ID (Advanced): This approach utilizes the Species ID, obtained via the API, to plant a specific tree species. However, it's important to note that the cost associated with this method is subject to fluctuation over time. As such, should you prefer to plant a specific species, it is advisable to verify the current cost through the API prior to each planting request, thereby mitigating potential discrepancies in pricing.
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.
To get started, please create an account in our test website. There you will be able to test the integration of the API. When ready, let us know through the form below and we will provide you with a token code for our live website.
Check our documentation
Click on this link to find our API documentation on Postman.
Request API Token
If you are testing our API on our test site, we will give you free credits in advance.
For more advanced features, please contact us at email@example.com
We keep improving it
Our API is built to be the ultimate gamification tool. We will make sure that it fits your configuration requirements and plan to keep developing its functionalities in the function of our client's feedback. So please do not hesitate to ask us for new features that would make sense for your business, we’ll try very hard to make it happen!