Start › For farm owners

Connect your farm's software to NextFarm with an API key

For farm owners, farm managers, or someone working for one farm (accountant, IT provider). No app needed.

① Create an API key

In the NextFarm app: System › API keys → Create key (choose scopes, expiry). The key is shown once. No key can control devices.

Open the app to create a key
Working for a farm? Copy instructions for the owner
Please create an API key for my software on NextFarm:
1. Open the NextFarm app › System › API keys › Create key.
2. Name it "Accounting software", pick only the read scopes needed (e.g. View parcels, View harvest batches), expiry 1 year.
3. Click Create, copy the nfk_… key (shown once) and send it to me privately.
Keys can never control devices; you can revoke it any time on the same screen.

② Check the key

The key is only used in this tab for one light read call.

③ What do you want to do?

Read parcels & seasons

Give accounting / ERP the parcels, areas and current crops.

Get alerts (Webhook)

Sensor thresholds, offline devices, new harvest batches → your URL. Turn on in System › Webhooks.

Connect n8n / Make

Use the HTTP node + an API key.

Declare harvest batches

Warehouse software declares batches, with Idempotency-Key against duplicates.

Let AI use the data → Connect an AI assistant (MCP)Building for many farms → Create an app

API key scopes

Maps & seasons

  • gis.parcels.view View parcels and seasons
  • gis.zones.view View zones
  • gis.farmers.view View farmers
  • gis.crop-types.view View crop types
  • gis.facilities.view View facilities
  • gis.layers.view View map layers

IoT (read-only)

  • iot.devices.view View devices
  • iot.telemetry.view View sensor readings
  • iot.telemetry.export Export sensor readings
  • iot.alerts.view View alerts

Harvest & traceability

  • harvest.harvest.view View harvest batches
  • harvest.harvest.create Create harvest batches (write)write
  • harvest.qr-codes.view View QR labels
  • harvest.trace.view View traceability
  • harvest.certification.view View certificates
  • harvest.market-prices.view View market prices

Farm books & tasks

  • office.base.record.view View book data
  • office.base.record.manage Add and edit book rows (write)write
  • office.task.view View tasks
  • office.calendar.view View calendar
  • office.automation.view View automation rules

Reports

  • report.view View reports
  • report.export Export reports