API Reference - Hacktionbase Docs

Overview

The Hacktionbase Public API is a REST API for server-side data ingestion. Use it to create users, accounts, and track events from your backend. Base URL: https://api.hacktionbase.com/v1

Authentication

All endpoints (except /health) require a Bearer token, issued from Settings → API Keys in the dashboard. Two key types exist:

Ingestion keys (ak_*) — for /users, /accounts, /events, /identify, /batch.
Public keys (hb_public_*) — for /contacts and /contacts/identify (lead capture). Despite the name, they are secret server-side credentials — never embed them in browser code.

curl -X POST https://api.hacktionbase.com/v1/users \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"externalId": "user_123", "email": "jane@example.com"}'

Response format

All mutation endpoints return 202 Accepted — data is processed asynchronously via a queue. This ensures high throughput and reliability.

Rate limits

API rate limits depend on your plan. If you exceed the limit, you’ll receive a 429 Too Many Requests response.

Endpoints

Health

Check API availability.

Users

Create or update user profiles.

Accounts

Create or update company accounts.

Events

Track custom events server-side.

Identify

Merge anonymous and identified users.

Batch

Send multiple operations in one request.

Contacts

Capture leads from any form submission.

Identify Contact

Resolve and identify an existing contact.

​Overview

​Authentication

​Response format

​Rate limits

​Endpoints