🚧
Before you begin — Partner OAuth integrations only
These guides assume your company’s Tech Partner application has been approved by the HiBob Tech Partnerships team, and you have access to both the HiBob Partner Portal and Developer Portal, including your OAuth credentials.

If you have yet to apply to become a Tech Partner, first submit the Tech Partner Application form. Once approved, you will need to accept the Tech Partner Terms in the HiBob Partner Portal (via PartnerStack), then activate a Bob account, and then receive an invitation to the Developer Portal, where you can begin your marketplace app/s onboarding.

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.

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 — become a partner if needed, create your app in the Developer Portal, configure OAuth, scopes, and webhooks, complete marketing listing content (Overview and About), prepare the technical package, and submit for separate listing and technical reviews. Security Review follows a separate timeline (mandatory before go-live for Payroll and Global Payroll).
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.

Partner community

Approved Marketplace partners can ask questions and share integration patterns with other builders in Bob for Builders.