v1

latestOpenAPI 3.0.02026-08-061380344.2 KB
Crops & Plantings

Create a Plant Type

Create a plant type

Parameters

type REQUIRED

Type of plant/crop. For example; Carrot, Tomato, Hops, Corn, etc


days_to_maturity OPTIONAL

Numeric value for days to maturity (DTM). For direct sow plantings this is the days from planting to harvest, for transplants it's the days from planting in the ground to harvest.


spacing OPTIONAL

Inches/Centimeter (based on account setting) spacing between plants


row_spacing OPTIONAL

Inches/Centimeter (based on account setting) spacing between rows


description OPTIONAL

Text description of the plant type


harvest_unit OPTIONAL

The unit used to record harvests for this plant type. Supported values are any of the following:

"Bales", "Barrels", "Bunches", "Bushels", "Dozen", "Fluid Ounces", "Gallons", "Grams", "Head", "Kilograms", "Kiloliter", "Liter", "Milliliter", "Ounces", "Pounds", "Quantity", "Quarts", "Tonnes", "Tons"

The default is to store harvests as Quantity


is_perennial OPTIONAL

Boolean value for if plant type if perennial or not. Defaults to false.


market_price OPTIONAL

Estimated / average market value for each harvest unit. Used to estimate harvest revenues.


planting_method OPTIONAL

Default planting method. Supported options are:

"Direct Sow", "Start in Trays, Transplant in Ground", "Transplant", "Container", "Root Stock", "Bulbs", "Grafting","Other"


seed_company OPTIONAL

Default seed company to be set for each new planting created from this plant type.


variety OPTIONAL

Plant variety, for example: Beef master, Russet, etc.


weeks_before_frost OPTIONAL

The number of weeks before the last frost that seeds should be started in trays or direct sown (depending on planting method)


days_to_emerge OPTIONAL

How many days (numeric value) for the plant to germinate on average


days_to_flowerOPTIONAL

How many days (numeric value) for the plant to flower on average


loss_rate OPTIONAL

A numeric value between 0-100 that represents the estimated percent of plants lost from seed to harvest. This is used when calculating estimated yields.


internal_id OPTIONAL

Custom text for internal ID used to identify the plant type


light_profile OPTIONAL

Ideal light profile for plant type. Supported options are:

"Full Sun", "Full to Part Sun", "Partial Sun", "Sun to Part Shade", "Partial Shade", "Full Shade"


soil_conditions OPTIONAL

Ideal soil conditions for plant type. Supported options are:

"Chalky", "Clay", "Loamy", "Peaty", "Sandy", "Silty"


planting_depth OPTIONAL

Text describing planting depth for seeds. For example 3/4" or 1-2 inches.


direct_sow OPTIONAL

Boolean value indicating if plant type is direct sow or not.


start_indoors OPTIONAL

Boolean value indicating if plant type should be started indoors or not.


yield_per_100_ft OPTIONAL

The average or expected yield (in harvest units) per 100 foot of plantings. This is used to estimate the expected yield for a planting when planting in beds.


yield_per_area OPTIONAL

The average or expected yield (in harvest units) per Acre/Hectare (based on account setting). This is used to estimate the expected yield for a planting when planting by area, not in a bed.


botanical_name OPTIONAL

Scientific / botanical name of the plant type.

post/plants

Headers

Content-Typestring

Request body

object required

Example request

{
  "days_to_maturity": 20,
  "description": "",
  "harvest_unit": "pounds",
  "is_perennial": false,
  "market_price": 4,
  "planting_method": "Direct Sow",
  "seed_company": "",
  "spacing": 2,
  "type": "Plant Type",
  "variety": "Variety",
  "weeks_before_frost": 4,
  "days_to_emerge": 30,
  "internal_id": "Custom ID",
  "light_profile": "Full Sun",
  "planting_depth": "1/2 an inch",
  "row_spacing": 6,
  "direct_sow": true,
  "start_indoors": false,
  "yield_per_100_ft": 100,
  "yield_per_area": 30000,
  "botanical_name": "Botanical Name"
}

Response

Successful response