Compartilhar via


Tree-Nation (Independent Publisher) (Preview)

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

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

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

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

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

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

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

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

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

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

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

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

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.