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

# How Chift works

Chift sits between your software and your customers' financial tools. Whichever way you use it, the same three objects show up — learn them once here.

## The three objects

Everything in Chift is built from three objects, and how they relate is the part worth getting straight up front:

<Frame caption="A consumer can hold several connections — but only one per connector.">
  <img src="https://mintcdn.com/chift/Fy9-9zDN2_VchWtm/assets/docs/developer-guides/three-objects.svg?fit=max&auto=format&n=Fy9-9zDN2_VchWtm&q=85&s=7c5b8759fa5f01cbf965a3d9fbd5dee5" alt="A consumer holds connections, each linking to one connector" width="1120" height="380" data-path="assets/docs/developer-guides/three-objects.svg" />
</Frame>

* **Connector** — software Chift talks to (Odoo, Sage, Shopify, Lightspeed). Chift builds and maintains these; you choose which to activate. In your product, an integration you offer.
* **Consumer** — one of your customers, identified by a uuid (`consumerid`). In your product, a tenant or account in your database — usually one per customer.
* **Connection** — one consumer linked to one connector, holding that customer's credentials and configuration. *"This customer connected their Odoo."*

<Note>
  Chift's API paths and fields use the word **integration** (`GET /integrations`, `integrationid`) for historical reasons. In the documentation we say **connector**. They mean the same thing.
</Note>

## Two ways to use Chift

Both start from the same connectors, consumers, and connections. What differs is who writes the integration logic and who triggers it.

<CardGroup cols={2}>
  <Card title="Unified API" icon="code" href="/developer-guides/unified-api/overview">
    **You build the integration and you have the lead.** You call Chift's endpoints directly and read or write your customers' data whenever your product needs to.
  </Card>

  <Card title="Syncs" icon="arrows-rotate" href="/developer-guides/syncs/overview">
    **Chift builds the integration and triggers the flows.** We set up the synchronisation with you and run it on an event or a schedule — no integration code on your side.
  </Card>
</CardGroup>

Most developers start with the Unified API. Syncs suit teams who would rather delegate the build and the running of the flow to Chift.

## Next steps

<CardGroup cols={2}>
  <Card title="Authenticate" icon="key" href="/developer-guides/chift-authentication">
    Exchange your API key for a bearer token — needed for both models.
  </Card>

  <Card title="Glossary" icon="book" href="/docs/introduction/glossary">
    Short definitions of every Chift term.
  </Card>
</CardGroup>
