Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.withleaf.io/llms.txt

Use this file to discover all available pages before exploring further.

Leaf connects to Lindsay FieldNET using OAuth 2.0 credentials. Once connected, Leaf syncs irrigation activity data for the Leaf user.

​
Prerequisites

  1. A Lindsay developer account with API access.
  2. Your application’s clientId and clientSecret from Lindsay.
  3. A grower’s refreshToken obtained through the Lindsay OAuth 2.0 consent flow.
  4. The clientEnvironment for your integration: STAGE or PRODUCTION.

​
Credentials schema

FieldTypeRequiredDescription
clientIdstringYesYour Lindsay application client ID.
clientSecretstringYesYour Lindsay application client secret.
refreshTokenstringYesThe grower’s OAuth refresh token.
clientEnvironmentstringYesSTAGE or PRODUCTION.

​
Endpoints

MethodPathDescription
GET/users/{leafUserId}/lindsay-credentialsGet stored credentials.
POST/users/{leafUserId}/lindsay-credentialsCreate credentials.
DELETE/users/{leafUserId}/lindsay-credentialsDelete credentials.
GET/users/{leafUserId}/lindsay-credentials/eventsGet credential events for troubleshooting.
Base URL: https://api.withleaf.io/services/usermanagement/api

​
Create credentials

curl -X POST \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "clientId": "your-client-id",
    "clientSecret": "your-client-secret",
    "refreshToken": "grower-refresh-token",
    "clientEnvironment": "PRODUCTION"
  }' \
  'https://api.withleaf.io/services/usermanagement/api/users/{leafUserId}/lindsay-credentials'

​
Response

{
  "id": "uuid",
  "status": "str",
  "createdTime": "2026-01-15T12:00:00.000000Z",
  "tokenMetadata": { "scopes": ["str"] },
  "clientId": "your-client-id",
  "clientSecret": "your-client-secret",
  "clientEnvironment": "PRODUCTION",
  "accessToken": "str",
  "refreshToken": "grower-refresh-token"
}

​
Troubleshooting

Use the events endpoint to check credential health. Events are retained for 30 days and are deleted when the credential is removed. 
GET /users/{leafUserId}/lindsay-credentials/events

​
What to do next

Last modified on March 19, 2026