John Deere

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.

​

Prerequisites

1. A John Deere developer account. Register here.
2. An application registered in the My Applications portal with the appropriate scopes and redirect URIs configured. Make sure Webhook Read and Webhook Write permissions are enabled under Operations Center - Webhook — this allows Leaf to receive real-time data notifications instead of relying solely on polling.
3. Your application’s clientKey and clientSecret from John Deere.
4. A grower’s refreshToken obtained through the John Deere OAuth 2.0 consent flow.

​

Setup steps

1. Complete the John Deere OAuth 2.0 flow to obtain a refreshToken for the grower’s account.
2. POST the credentials to Leaf:

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

3. Leaf validates the token and begins syncing. Check credential status with GET /users/{leafUserId}/john-deere-credentials.

​

Credentials schema

{
  "id": "uuid",
  "status": "str",
  "createdTime": "yyyy-MM-dd'T'HH:mm:ss.SSSSSS'Z'",
  "tokenMetadata": {"scopes": ["str"]},
  "clientKey": "str",
  "clientSecret": "str",
  "accessToken": "str",
  "refreshToken": "str",
  "clientEnvironment": "PRODUCTION"
}

​

Endpoints

​

Troubleshooting

curl -X GET \
    -H 'Authorization: Bearer YOUR_TOKEN' \
    'https://api.withleaf.io/services/usermanagement/api/users/{leafUserId}/john-deere-credentials/events'

• Status changes to invalid: The grower may have revoked access in John Deere Operations Center, or the refresh token expired. Have the grower re-authorize through the OAuth flow.
• Missing organizations: If expected data isn’t appearing, check whether organizationDataSync is set to SELECTED_ONLY and verify the correct organizations are selected.
• STAGE vs. PRODUCTION mismatch: Make sure clientEnvironment matches the environment your John Deere app is registered in.

​

What to do next

• Connect John Deere Tutorial — Step-by-step walkthrough.
• Provider Authentication Overview — How provider credentials work across all providers.
• API Reference: Providers — Full endpoint reference for provider credentials.