Trimble

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 Trimble Agriculture developer account. Register here.
2. Your application’s clientId and clientSecret from Trimble.
3. A grower’s refreshToken obtained through the Trimble OAuth 2.0 consent flow.

​

Setup steps

1. Complete the Trimble 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 '{
      "clientId": "your-client-id",
      "clientSecret": "your-client-secret",
      "refreshToken": "grower-refresh-token"
    }' \
    'https://api.withleaf.io/services/usermanagement/api/users/{leafUserId}/trimble-credentials'

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

​

Credentials schema

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

​

Endpoints

​

Troubleshooting

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

• Status changes to invalid: The grower may have revoked access or the refresh token expired. Have the grower re-authorize through Trimble’s OAuth flow.

​

What to do next

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