CLAAS

​

Prerequisites

1. OAuth client credentials (clientKey and clientSecret) for the CLAAS partner/OFT API.
2. A grower’s refreshToken obtained through the CLAAS OAuth 2.0 consent flow.

​

Setup steps

1. Complete the CLAAS 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}/claas-credentials'

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

​

Credentials schema

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

​

Endpoints

​

Troubleshooting

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

• Status changes to invalid: The grower may have revoked access or the refresh token expired. Have the grower re-authorize through the CLAAS OAuth flow.
• STAGE vs. PRODUCTION mismatch: Make sure clientEnvironment matches the environment your CLAAS app is registered in. If omitted, Leaf defaults to STAGE.

​

What to do next

• Provider Authentication Overview — How provider credentials work across all providers.
• API Reference: Providers — Full endpoint reference for provider credentials.