Leaf connects to Sentera using username/password authentication rather than OAuth. Once connected, Leaf syncs field boundary data for the Leaf user. Sentera is primarily used for field boundary management.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
- A Sentera account with the target organization.
- The grower’s
usernameandpasswordfor their Sentera account. - The
organizationNamewithin Sentera that the grower belongs to.
Setup steps
POST the credentials to Leaf:Credentials schema
Create request body:| Field | Type | Required | Description |
|---|---|---|---|
username | string | Yes | The grower’s Sentera username |
password | string | Yes | The grower’s Sentera password |
organizationName | string | Yes | The Sentera organization name |
authToken and resolves the organizationId from the provided organizationName after successful authentication.
Confirm the credentials are attached
Check the stored credentials for the Leaf user:organizationId.
Endpoints
Base URL:https://api.withleaf.io/services/usermanagement/api
| Action | Method | Path |
|---|---|---|
| Get credentials | GET | /users/{leafUserId}/sentera-credentials |
| Create credentials | POST | /users/{leafUserId}/sentera-credentials |
| Delete credentials | DELETE | /users/{leafUserId}/sentera-credentials |
| Get credential events | GET | /users/{leafUserId}/sentera-credentials/events |
Troubleshooting
Use the events endpoint to inspect credential health:- Invalid credentials: If the grower changed their Sentera password, the credentials stored in Leaf become invalid. Delete and recreate with the new password.
- Organization not found: Verify the
organizationNamematches exactly what’s configured in Sentera, including case sensitivity.
What to do next
- Fields Overview for how Sentera field boundaries appear in Leaf.
- Managing Fields for working with the synced boundaries.
- Provider Credentials API Reference for the credential path matrix.

