---
updatedAt: 2026-08-03T15:34:04.000Z
---

Fetch the complete documentation index at: https://apidocs.hibob.com/llms.txt. Use this file to discover all available pages before exploring further.

# Marketplace partner integrations

Documentation for approved HiBob Marketplace partners building OAuth app integrations via the Developer Portal

<Callout icon="🚧" theme="warn">
  **Partner OAuth integrations only**

  These guides are for **approved HiBob Marketplace and technology partners** with Developer Portal access and OAuth credentials.

  - **Bob customers** building integrations for their own company should use [Service Users](/docs/api-service-users) and [Authorization](/reference/authorization), not OAuth.
  - OAuth app installation, Developer Portal access, and partner webhook behavior are **not available** to general Public API users.
  - To join the partner program, see [Become a partner](https://www.hibob.com/partner/).
</Callout>

# Overview

This section is for partners who build **Marketplace apps** that customers install via OAuth. It covers the Developer Portal workflow and partner-specific webhook delivery.

OAuth reference material (authorization protocol, token exchange, refresh) lives under **[Core concepts for partners (OAuth only)](/reference/oauth-20)** in the API Reference.

Implementation guides for multi-tenant installations, user flows, and uninstall are in this **Marketplace partner integrations** section below.

If you are a **Bob customer** integrating with your own Bob account, start with [Getting started with Bob's API](/docs/getting-started) and [API Service Users](/docs/api-service-users).

# Partner journey

1. [Quick start guide](/docs/add-and-submit-an-app) — create your app in the Developer Portal, configure OAuth, scopes, and webhooks, and submit for review.
2. [OAuth 2.0](/reference/oauth-20) — authorization code flow, token exchange, refresh, and development uninstall (API Reference).
3. [Scopes mapping to endpoints](/reference/scopes-mapping-to-endpoints) — choose the minimum scopes your app needs.
4. ​[Getting started with partner webhooks](/docs/getting-started-with-partner-webhooks) — delivery, retries, and routing events by `companyId`.
5. [Managing customer installations](/docs/managing-customer-installations) — multi-tenant model: link Bob companies to your customers, store tokens, track status.

#