Integrating Hiver
Auth: OAuth 2.0 · Partner program: not required · Setup time: about 25 minutes · Last verified: 2026-05-23
Hiver bolts shared-inbox and ticketing functionality onto Gmail and Microsoft 365. The adapter targets the Hiver REST API and exposes conversations, contacts, and agents into the canonical customer-support schema.
Auth model
Section titled “Auth model”- OAuth 2.0 Authorization Code grant. Hiver issues OAuth credentials through the in-app developer console at Admin → Developer settings → Create app.
- The adapter also accepts a static API key when a tenant prefers a single-account integration over user-delegated OAuth.
Exact authorize and token URLs are scoped to your tenant — Hiver provisions them when you create the app and surfaces them in the developer console rather than publishing them as a global pair. Copy them into the adapter’s authUrl / tokenUrl settings as part of configuration.
Prerequisites
Section titled “Prerequisites”- A Hiver account with admin access at hiverhq.com. The underlying mailbox (Gmail or Microsoft 365) must already be authorized to Hiver — the adapter does not re-mint Gmail / Graph tokens on Hiver’s behalf.
- An app registered in Admin → Developer settings. Note the generated Client ID and Client Secret, and add the redirect URI.
Configure in admin
Section titled “Configure in admin”- Open
/platformsin the admin UI, filter to Customer Support, click Hiver. - Fill Configure:
clientId— from Hiver Developer settings.clientSecret— from Hiver Developer settings.redirectUri—${PUBLIC_BASE_URL}/auth/customer-support/hiver/callback.authUrl/tokenUrl— copy from the developer console.
- Enable the adapter.
Required scopes
Section titled “Required scopes”Scope catalog is exposed through the developer console rather than as a public list — request only the scopes covering conversations, contacts, and agents for the canonical surface. Hiver’s defaults grant read access; writes (assign, status change, reply) require explicit write scopes.
Webhooks
Section titled “Webhooks”Hiver delivers webhook events for conversation lifecycle changes. Configure them under Admin → Webhooks; HMAC-SHA256 signing is supported when you set a shared secret. Subscribe to conversation create / update / assignment / status events.
Quirks worth knowing
Section titled “Quirks worth knowing”- Rate limit is 1 RPS per account. The strictest in the vertical — the adapter throttles and serialises writes per tenant. Bulk operations must be paced by the caller.
- Mailbox provider tokens stay with Hiver. The adapter never touches Gmail or Graph directly; threads return Hiver-side IDs.
- Tenant-pinned endpoints. Even token URLs are tenant-scoped — do not hardcode them across tenants.
References
Section titled “References”opensteward.dev ·Plans and free license ·Terms ·Privacy ·support@opensteward.dev
© 2026 Falco Consulting AB. Built from open-steward/opensteward@a3961d8. This site sets no cookies, runs no analytics and loads nothing from other sites, except platform logos from Brandfetch on the Platforms page.