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

# How to integrate your customer via Kombo

> A checklist for connecting a customer end to end: your setup, their connection flow, and what changes for enterprise tools.

Every integration has two sides: **your setup**, and **your customer connecting
their tool**. Use this page as a checklist for the whole path.

For step-by-step tool instructions (API keys, OAuth screens, required
permissions), use the [Connection Guides](/help-center/connection-guides). For
embedding the flow in your product, see
[Kombo Connect](/hris/guides/connect/embedded-flow).

***

## 1. What you do

### Prerequisites

* **Configure [scopes](https://app.kombo.dev).** The exact data points Kombo
  requests. Keep them as tight as your use case allows. See
  [Permissions and scopes](/permissions-and-scopes).
* **Check coverage.** Confirm the tool is supported and that it supports your
  use case on the [coverage grid](https://app.kombo.dev) and
  [tools page](https://app.kombo.dev).

### Checklist

* [ ] **Step 1 — Confirm the tool is enabled and read the limitations**
  * Open the [Tools page](https://app.kombo.dev) and confirm the tool is
    enabled for your environment.

  * Read the tool’s limitations before you invite the customer. Not every tool
    exposes everything through its API — some have partial APIs or need
    workarounds, and a few fields or write actions may not be available.

  * Use **Coverage** for a high-level overview (tip: filter by your scope).

    <Frame>
      <img src="https://mintcdn.com/kombo/VvJumeb-3SAT_PaQ/images/help-center/onboarding/coverage-limitations.png?fit=max&auto=format&n=VvJumeb-3SAT_PaQ&q=85&s=b9f0c82b61168d69472138fa3a1749e8" alt="Kombo Coverage page filtered by scope, showing supported features and limitations across tools" width="1408" height="810" data-path="images/help-center/onboarding/coverage-limitations.png" />
    </Frame>

  * Open the specific **tool page** for details, the connection flow, guides,
    and other docs (tip: filter limitations by your scope).

    <Frame>
      <img src="https://mintcdn.com/kombo/VvJumeb-3SAT_PaQ/images/help-center/onboarding/tool-page.png?fit=max&auto=format&n=VvJumeb-3SAT_PaQ&q=85&s=4c5130ccae40791af7227a658969f030" alt="Kombo tool page showing overview, connection flow, guide, and limitations" width="1406" height="634" data-path="images/help-center/onboarding/tool-page.png" />
    </Frame>

* [ ] **Step 2 — Choose how your customer connects**

  | Path                | How it works                                                                                              | Best for                      |
  | ------------------- | --------------------------------------------------------------------------------------------------------- | ----------------------------- |
  | **Embedded flow**   | Kombo Connect lives inside your product. The customer opens your product, picks their tool, and connects. | Self-serve                    |
  | **Connection link** | Generate a connection link from **Integrations** or **Tools**, then send it to your customer.             | Enterprise or guided launches |

  <Note>
    For the engineering setup of the embedded flow, see [Embedded
    flow](/hris/guides/connect/embedded-flow).
  </Note>

* [ ] **Step 3 — Send the link (or point them to your product)**
  * Embedded flow: customer starts from your product.
  * Connection link: send the link you generated in Step 2.

* [ ] **Step 4 — Monitor progress**

  * **[Pending Connections](https://app.kombo.dev)** — integrations that have
    not been started or finished.
  * **[Integrations](https://app.kombo.dev)** — successfully connected
    integrations (statuses can vary).

  <Frame>
    <img src="https://mintcdn.com/kombo/VvJumeb-3SAT_PaQ/images/help-center/onboarding/monitoring.png?fit=max&auto=format&n=VvJumeb-3SAT_PaQ&q=85&s=8ecf080763d68af00fa8ea4d291fadc9" alt="Kombo Integrations page showing connected integrations, statuses, and a banner for pending connections" width="1406" height="788" data-path="images/help-center/onboarding/monitoring.png" />
  </Frame>

***

## 2. What your customer does

### Prerequisites

* The person connecting needs **admin access**. They must have the right admin
  level in their tool to authorise the connection and grant the requested
  scopes. This is generally an admin or equivalent.

<Warning>
  Line this person up **before** you send the link. The wrong person is the
  number-one reason a connection stalls. The [connection
  guide](/help-center/connection-guides) for each tool highlights the required
  access level.
</Warning>

<Frame>
  <img src="https://mintcdn.com/kombo/VvJumeb-3SAT_PaQ/images/help-center/onboarding/admin-access-guide.png?fit=max&auto=format&n=VvJumeb-3SAT_PaQ&q=85&s=095a0e43bdd94d85b46fd99d46a8ee78" alt="Example connection guide calling out the admin access required to connect" width="1406" height="838" data-path="images/help-center/onboarding/admin-access-guide.png" />
</Frame>

### Checklist

* [ ] **Step 1 — Open the connection**
  * They open the connection link you sent them.
  * If Kombo is embedded in your product, they select their tool from there.

* [ ] **Step 2 — Follow the connection flow**
  * They review and approve the requested data (your scopes).

* [ ] **Step 3 — Authorise the connection**
  * **OAuth tools** — they sign in and approve access, like single sign-on.
    Nothing to create.

    <Frame>
      <img src="https://mintcdn.com/kombo/VvJumeb-3SAT_PaQ/images/help-center/onboarding/oauth-authorize.png?fit=max&auto=format&n=VvJumeb-3SAT_PaQ&q=85&s=420c8f5586deea798c9fc2a711661bd3" alt="OAuth connection flow: review permissions, sign in, complete setup steps, success" width="1336" height="578" data-path="images/help-center/onboarding/oauth-authorize.png" />
    </Frame>

  * **API-credential tools** — they generate an API key (sometimes a secret)
    inside their tool and paste it in.

    <Frame>
      <img src="https://mintcdn.com/kombo/VvJumeb-3SAT_PaQ/images/help-center/onboarding/api-credentials.png?fit=max&auto=format&n=VvJumeb-3SAT_PaQ&q=85&s=9db381def88381ec911aa18bccbd774d" alt="API credential connection flow: create API key in the tool and paste it into Kombo Connect" width="1334" height="576" data-path="images/help-center/onboarding/api-credentials.png" />
    </Frame>

* [ ] **Step 4 — Confirm success**
  * When the integration is successful, no further action is required from your
    customer.

***

## Enterprise customers and enterprise tools

Enterprise customers generally use enterprise systems (for example Workday,
SuccessFactors, Oracle). These tools often require more time and steps. Treat
them as **guided launches**, not self-serve.

<Frame>
  <img src="https://mintcdn.com/kombo/VvJumeb-3SAT_PaQ/images/help-center/onboarding/enterprise-tools.png?fit=max&auto=format&n=VvJumeb-3SAT_PaQ&q=85&s=810e7d7c7132c5e233d1a57f7b5de7bc" alt="Workday connection flow with extra setup steps typical of enterprise tools" width="1406" height="256" data-path="images/help-center/onboarding/enterprise-tools.png" />
</Frame>

### Checklist

* [ ] **Prepare for security questions** — Expect questions about data security
  and access. Keep scopes tight and be ready to explain exactly what you
  request.
* [ ] **Line up the right person early** — They need admin rights and the
  ability to set permissions. This may be someone you are not yet speaking
  with.
* [ ] **Run through the process with your customer** — Enterprise tools often
  gate data behind specific permission areas. Know those requirements
  before your customer hits them in the flow.

***

## Connection stuck or not completing?

See [Troubleshoot connection flow problems](/hris/guides/debugging/debug-connection-flow)
for statuses and the most common issues.

***

## Related docs

* [Onboarding your customers](/help-center/onboarding) — Connect flows, invite
  links, and rollout
* [Connection guides](/help-center/connection-guides) — Per-tool setup
  instructions
* [Permissions and scopes](/permissions-and-scopes) — Request only the data you
  need
* [Embedded flow](/hris/guides/connect/embedded-flow) — Implement Kombo Connect
  in your product
* [Best practices](/help-center/best-practices) — Scopes, syncing, and error
  handling
