🚧
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 and 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.

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) 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 and API Service Users.

Partner journey

Quick start guide — create your app in the Developer Portal, configure OAuth, scopes, and webhooks, and submit for review.
Test apps in Bob Marketplace (Dev mode) — in Bob, open Bob products > Marketplace > Manage apps > In development to see your Developer Portal apps (Dev mode) on your partner company.
OAuth 2.0 — authorization code flow, token exchange, refresh, and development uninstall (API Reference).
Scopes mapping to endpoints — choose the minimum scopes your app needs.
Getting started with partner webhooks — delivery, retries, and routing events by companyId.
Managing customer installations — multi-tenant model: link Bob companies to your customers, store tokens, track status.