Tree-Nation (Independent Publisher) (Preview)

  • Reference

The simplest way for citizens and companies to plant trees around the world and offset their CO2 emissions. Tree-Nation is on a mission to plant 1 trillion trees by 2050.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name Troy Taylor
URL https://www.hitachisolutions.com
Email ttaylor@hitachisolutions.com
Connector Metadata
Publisher Troy Taylor
Website https://tree-nation.com/
Privacy policy https://tree-nation.com/legal/privacy-policy
Categories Lifestyle and Entertainment

Creating a connection

The connector supports the following authentication types:
Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
API Key (in the form 'Bearer API_Token') securestring The API Key (in the form 'Bearer API_Token') for this api True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Buy credit

Buy credit.
Create user

Create a new user.
Forest details

Retrieve a user forest details
Forest tree count

Retrieve a user forest tree count (by slug). Period is optional and can be one of: day, week, month, quarter, year. If period is not passed, the all time value will be returned.
Plant

Plant a tree.
Project details

Retrieve the details about a project.
Project list

Retrieve all projects. If the parameter status=active is passed, only active projects (those where a tree can be planted) will be listed.
Sites list

Retrieve the available planting sites in a project.
Species details

Retrieve the details about a species.
Species list

Retrieve the available species in a project. Only those species with stock > 0 can be used for planting.
Tree template details

Retrieve the details about the tree template of a planter.
Update tree template

Modify the message of a tree template.

Buy credit

Operation ID:
BuyCredit

Buy credit.

Parameters

Name Key Required Type Description
Planter ID
 planter_id integer

The planter identifier.
Amount
 amount integer

The amount.

Returns

Name Path Type Description
Status
 status string

The status.
Payment ID
 payment_id integer

The payment identifier.

Create user

Operation ID:
CreateUser

Create a new user.

Parameters

Name Key Required Type Description
Name
 name string

The name.
Email
 email string

The email address.
Language
 language string

The language.
Password
 password string

The password.
Responsible Name
 responsible_name string

The responsible name.
Organization Website
 organization_website string

The organization website.

Returns

Name Path Type Description
Status
 status string

The status.
User ID
 user_id integer

The user identifier.
Password
 password string

The password.
Slug
 slug string

The slug.
Forest URL
 forest_url string

The forest URL address.

Forest details

Operation ID:
ForestDetails

Retrieve a user forest details

Parameters

Name Key Required Type Description
User ID
 user_id True string

The user identifier.

Returns

Name Path Type Description
ID
 id integer

The identifier.
CO2 Compensated
 co2_compensated float

The CO2 compensated.
Tree Count
 tree_count string

The tree count.

Forest tree count

Operation ID:
ForestTreeCount

Retrieve a user forest tree count (by slug). Period is optional and can be one of: day, week, month, quarter, year. If period is not passed, the all time value will be returned.

Parameters

Name Key Required Type Description
user slug
 user_slug True string

The user slug.
Period
 period True string

The period.

Returns

Name Path Type Description
Count
 count integer

The count.

Plant

Operation ID:
Plant

Plant a tree.

Parameters

Name Key Required Type Description
Name
 name string

The name.
Email
 email string

The email address.
Planter ID
 planter_id integer

The planter identifier.
Species ID
 species_id integer

The species identifier.
Quantity
 quantity integer

The quantity.
Message
 message string

The message.

Returns

Name Path Type Description
Status
 status string

The status.
Trees
 trees array of object
ID
 trees.id integer

The identifier.
Token
 trees.token string

The token.
Collect URL
 trees.collect_url string

The collection URL address.
Certificate URL
 trees.certificate_url string

The certificate URL address.
Payment ID
 payment_id integer

The payment identifier.

Project details

Operation ID:
ProjectDetails

Retrieve the details about a project.

Parameters

Name Key Required Type Description
Project ID
 project_id True string

The project identifier.

Returns

Name Path Type Description
ID
 id integer

The identifier.
Name
 name string

The name.
Description
 description string

The description.
Image
 image string

The image.
Slug
 slug string

The slug.
Location
 location string

The location.
Latitude
 lat float

The latitude.
Longitude
 long float

The longitude.
Status
 status string

The status.
URL
 url string

The URL address.
Species Price From
 species_price_from float

The species price from.

Project list

Operation ID:
ProjectList

Retrieve all projects. If the parameter status=active is passed, only active projects (those where a tree can be planted) will be listed.

Parameters

Name Key Required Type Description
Status
 status True string

The status.

Returns

Name Path Type Description
array of object
ID
 id integer

The identifier.
Name
 name string

The name.
Description
 description string

The description.
Slug
 slug string

The slug.
Location
 location string

The location.
Latitude
 lat float

The latitude.
Longitude
 long float

The longitude.
Status
 status string

The status.
URL
 url string

The URL address.
Species Price From
 species_price_from float

The species price from.

Sites list

Operation ID:
SitesList

Retrieve the available planting sites in a project.

Parameters

Name Key Required Type Description
Project ID
 project_id True string

The project identifier.

Returns

Name Path Type Description
array of object
Address
 address string

The address.
Created At
 created_at string

When created at.
Description
 description string

The description.
ID
 id integer

The identifier.
Image
 image string

The image.
Name
 name string

The name.
Polygon Data
 polygon_data string

The polygon data.
Project ID
 project_id integer

The project identifier.
Slug
 slug string

The slug.

Species details

Operation ID:
SpeciesDetails

Retrieve the details about a species.

Parameters

Name Key Required Type Description
Species ID
 species_id True string

The species identifier.

Returns

Name Path Type Description
ID
 id integer

The identifier.
Project ID
 project_id integer

The project ID.
Name
 name string

The name.
Lifetime CO2
 life_time_CO2 integer

The lifetime CO2.
Price
 price integer

The price.
Common Names
 common_names string

The common name.
Image
 image string

The image.
Family
 family string

The family.
Particularities
 particularities string

The particularities.
Planter Likes
 planter_likes string

The planter likes.
Height
 height string

The height.
Average Natural Life Span
 average_natural_life_span integer

The average natural life span.
CO2 Offset
 co2_offset integer

The CO2 offset.
CO2 Offset Period
 co2_offset_period string

The CO2 offset period.
Stock
 stock integer

The stock.
ID
 category.id integer

The identifier.
Name
 category.name string

The name.
ID
 foliage.id integer

The identifier.
Name
 foliage.name string

The name.
ID
 origin_type.id integer

The identifier.
Name
 origin_type.name string

The name.

Species list

Operation ID:
SpeciesList

Retrieve the available species in a project. Only those species with stock > 0 can be used for planting.

Parameters

Name Key Required Type Description
Project ID
 project_id True string

The project identifier.

Returns

Name Path Type Description
array of object
ID
 id integer

The identifier.
Project ID
 project_id integer

The project identifier.
Name
 name string

The name.
Lifetime CO2
 life_time_CO2 integer

The lifetime CO2.
Price
 price integer

The price.
Stock
 stock integer

The stock.

Tree template details

Operation ID:
TreeTemplateDetails

Retrieve the details about the tree template of a planter.

Parameters

Name Key Required Type Description
Planter ID
 planter_id True string

The planter identifier.

Returns

Name Path Type Description
ID
 id integer

The identifier.
Planter ID
 planter_id integer

The planter identifier.
Message
 message string

The message.
Image
 image string

The image.
Video
 video string

The video.
Species ID
 species_id integer

The species identifier.
Package Quantity
 package_quantity integer

The package quantity.
Price Per Tree
 price_per_tree integer

The price per tree.
Total Price
 total_price integer

The total price.

Update tree template

Operation ID:
UpdateTreeTemplate

Modify the message of a tree template.

Parameters

Name Key Required Type Description
Planter ID
 planter_id True string

The planter identifier.
Message
 message string

The message.

Returns

Name Path Type Description
ID
 id integer

The identifier.
Planter ID
 planter_id integer

The planter identifier.
Video
 video string

The video.
Species ID
 species_id integer

The species identifier.
Package Quantity
 package_quantity integer

The package quantity.
Price Per Tree
 price_per_tree integer

The price per tree.
Total Price
 total_price integer

The total price.
Message
 message string

The message.
Image
 image string

The image.