Skip to main content

​
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. Use your API key from Settings → API Keys in the dashboard. 
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.