Hive API - Beta Documentation

Welcome to the Hive API beta! This document provides everything you need to start integrating with our new push-based data ingestion API.

<aside>

Beta Launch: April 1, 2026

Questions? Reach out to [email protected] or [email protected]

Early Access: Contact Tiffany - [email protected] if you'd like access before the official launch.

</aside>

What is the Hive API?

The Hive API allows you to push contact, order, and event data directly into Hive. Instead of Hive pulling data from your systems, you send it to us — giving you full control over when and what data is synced.

Key characteristics:

Push-based — You send data to Hive when it's ready
Asynchronous — Requests are acknowledged immediately (202 response), then processed in the background
Eventually consistent — Data typically appears within minutes, though during beta, processing may take up to 1 hour

Base URL

<https://api.hive.co/v2>

Authentication

Authorization

Rate Limits & Constraints

Constraint	Limit
Requests per second	1 sustained / 2 burst
Items per batch	50 max
Request body size	1 MB max

What happens when limits are exceeded:

Scenario	Response
Too many requests	`429 Too Many Requests`
Payload too large	`413 Payload Too Large`
Invalid payload	`422 Unprocessable Entity`