> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agronome.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Connecting John Deere

> Import farms, fields, and boundaries from JD Operations Center

# Connecting John Deere

agronome.ai integrates with John Deere Operations Center to import your farms, fields, and boundaries. The connection uses OAuth 2.0 — your JD credentials are never stored.

## Prerequisites

* An active John Deere Operations Center account
* Admin or Owner role in your agronome.ai organization

## Setup

<Steps>
  <Step title="Open Integrations">
    Navigate to **Settings → Integrations** in your organization.
  </Step>

  <Step title="Connect John Deere">
    Click **Connect** on the John Deere card. You'll be redirected to John Deere's authorization page.
  </Step>

  <Step title="Authorize access">
    Sign in to your JD account and grant agronome.ai read access to your organizations, farms, fields, and boundaries. Approve the requested permissions.
  </Step>

  <Step title="Select data to import">
    After authorization, you'll see your JD organization hierarchy. Select which organizations, farms, and fields to import. Field boundaries sync automatically.
  </Step>
</Steps>

## What gets imported

| JD Concept    | agronome.ai Mapping                      |
| ------------- | ---------------------------------------- |
| Organization  | Organization (linked via `external_ids`) |
| Farm / Client | Farm                                     |
| Field         | Field                                    |
| Boundary      | FieldBoundary (active version)           |
| Crop Zone     | CropZone (if available)                  |

## Data sync

* **Initial import** — full sync of selected entities
* **Re-import** — run again from Settings → Integrations to pick up new fields or boundary changes
* **Deduplication** — fields already imported (matched by JD external ID) are updated, not duplicated

## Disconnecting

To revoke access, go to **Settings → Integrations** and click **Disconnect** on the John Deere card. This removes the stored OAuth tokens but does not delete any imported data.

<Note>
  Continuous background sync (automatic re-import on changes) is planned for a future release.
</Note>