# Connecting an Integration

Connecting an integration takes a minute or two: find the source on the **Integrations** page, click **Connect**, and either sign in to the provider or fill in the credentials it asks for. Peaky starts the first sync straight away.

For the steps and details of a particular provider, open its page:

| Page | Integrations |
|------|--------------|
| [Accounting & ERP](/doc/accounting-fSYP3czo81) | Exact, Octopus, Sage, QuickBooks, Yuki, EMAsphere, Light, Rillet, Odoo, Business Central, Dynamics NAV, SAP Business One, SAP S/4HANA |
| [CRM](/doc/crm-crcWWlCuk8) | Hubspot, Teamleader, Attio, Twenty |
| [HR](/doc/hr-L5uTLF7uuV) | Officient, SD Worx |
| [Payments & Subscriptions](/doc/payments-subscriptions-RzUvZrlDPn) | Stripe, Mollie, Chargebee |
| [E-commerce](/doc/e-commerce-RJvoElMn3w) | Shopify      |
| [Data Warehouses & Spreadsheets](/doc/data-warehouses-spreadsheets-JkDU4OvzYr) | Peliqan, Google Sheets |
| [Power BI](/doc/power-bi-txQtaHahuE) | Power BI     |
| [FX Rates](/doc/fx-rates-MWLBhDyYCh) | FX Rates     |

The API has its own page: [Pushing Data with the API](/doc/pushing-data-with-the-api-5Nan2cfvu4). AI tools are not connected per company but once per person, from **My account** — see [Connecting AI Tools (MCP)](/doc/connecting-ai-tools-mcp-AH34CwO7Nl). Slack is covered under [Integration Settings](/doc/integration-settings-H4x38V0Hgg#slack-notifications).


---

## Before You Start

* **Pick the right entity.** When your company has more than one legal entity, open **Integrations** for the entity that should own the data — switch in the sidebar first. The connection belongs to that entity, and its first sync runs for it.
* **Check your rights.** Connecting a new source needs the integration **Create** right; the built-in **Admin** role has it, **User** does not. See [Team & Roles](/doc/team-roles-ORspfM4rgP).
* **Check your access at the provider.** Signing in to a provider only works with an account that is allowed to grant access to other apps — often an administrator. If yours is not, use **Ask someone else** (below).


---

## Connecting


1. Open **Integrations** and find the source. Use the search box or the category tabs to narrow the list.
2. Click **Connect** (**Enable** for FX Rates and the API).
3. Finish the connection in one of the ways below.

### Signing in to the provider

For most integrations, **Connect** takes you to the provider's own sign-in and consent screen. Sign in, approve the access Peaky asks for, and you come back to the **Integrations** page with the card marked **Connected**.

A few providers need something from you before the sign-in: Twenty asks whether you use the cloud or your own server, Shopify asks for your shop domain, Peliqan for your region, and SAP for your server addresses. Business Central and Google Sheets add a step after it, to choose a company or the spreadsheets to sync.

Peaky renews the access in the background, so daily syncs keep working without you signing in again. If the provider stops accepting it, the card tells you — see [Fixing a Connection](/doc/fixing-a-connection-jKz29zCMG7).

### Entering credentials

For Yuki, EMAsphere, Rillet, Odoo, Dynamics NAV, Chargebee and SD Worx (and Light, when you use an API key), **Connect** opens a dialog. It explains where to find each value in the provider's system; fill in the form and click **Connect**. Most providers' credentials are checked when you click **Connect**. If the card is not marked **Connected**, check each value against the provider and try again.

### Enabling a built-in integration

FX Rates and the API have nothing to sign in to. **Enable** opens a short dialog that switches them on.

### Asking someone else to connect

When your own provider account cannot authorize Peaky, open the **more** menu (**...**) on the card and choose **Ask someone else**. You get a private link for a colleague or your accountant to finish the sign-in — see [Connection Links](/doc/connection-links-dAnr715CtJ).


---

## After Connecting

* The card is marked **Connected** and the **first sync** starts automatically. Follow it in **Logs**, in the card's **more** menu (**...**); see [Syncing](/doc/syncing-3ZOS5zQpM7).
* A few integrations open their settings for you: check the **Exact** division, choose the **Octopus** dossier (Octopus cannot sync until you do), and confirm the **Odoo** modules — see [Integration Settings](/doc/integration-settings-H4x38V0Hgg).
* From then on the source syncs **daily**, and you can run a manual sync whenever you need fresher data.
* Accounting and ERP books show up under **Ledgers**, **Transactions** and the statement widgets on **Views**; operational data appears on **Metrics**, and — when custom metrics are enabled for your company — as tables on the **Data** page.

If something does not work, see [Fixing a Connection](/doc/fixing-a-connection-jKz29zCMG7).

---

**Documents**

- [Accounting & ERP](https://docs.peaky.ai/s/052dba34-0c8e-4a5d-90a7-c0572642e54f/doc/accounting-erp-fSYP3czo81)
- [CRM](https://docs.peaky.ai/s/052dba34-0c8e-4a5d-90a7-c0572642e54f/doc/crm-crcWWlCuk8)
- [HR](https://docs.peaky.ai/s/052dba34-0c8e-4a5d-90a7-c0572642e54f/doc/hr-L5uTLF7uuV)
- [Payments & Subscriptions](https://docs.peaky.ai/s/052dba34-0c8e-4a5d-90a7-c0572642e54f/doc/payments-subscriptions-RzUvZrlDPn)
- [E-commerce](https://docs.peaky.ai/s/052dba34-0c8e-4a5d-90a7-c0572642e54f/doc/e-commerce-RJvoElMn3w)
- [Data Warehouses & Spreadsheets](https://docs.peaky.ai/s/052dba34-0c8e-4a5d-90a7-c0572642e54f/doc/data-warehouses-spreadsheets-JkDU4OvzYr)
- [Power BI](https://docs.peaky.ai/s/052dba34-0c8e-4a5d-90a7-c0572642e54f/doc/power-bi-txQtaHahuE)
- [FX Rates](https://docs.peaky.ai/s/052dba34-0c8e-4a5d-90a7-c0572642e54f/doc/fx-rates-MWLBhDyYCh)