Developer Documentation

Bizowl API Reference

Integrate Bizowl's AI-powered marketing intelligence into your own applications. Full REST API access available on Professional plans and above.

Quick Start

1
Authenticate

Sign in via OAuth to receive a session cookie that authenticates all API calls.

2
Make Requests

Call tRPC endpoints via HTTP GET (queries) or POST (mutations) with JSON payloads.

3
Handle Responses

All responses are JSON with consistent error codes. Rate limits are returned in headers.

# Example: Get dashboard overview
curl -X GET 'https://bizowl.io/api/trpc/meta.dashboardOverview?input={"brandId":1,"datePreset":"last_30d"}' \
  -H 'Cookie: app_session_id=YOUR_SESSION_TOKEN' \
  -H 'Content-Type: application/json'

Authentication

OAuth 2.0 session-based authentication. All protected endpoints require a valid session cookie. Tokens auto-refresh. No API keys needed.

Rate Limits

120 requests/minute per session. AI generation endpoints: 20 requests/minute. Rate limit headers included in all responses. 429 status on exceeded.

Data Format

All responses are JSON (SuperJSON serialized). Dates are ISO 8601. Monetary values in pence (divide by 100 for pounds). Errors use standard tRPC codes.

Authentication

GET/api/trpc/auth.me

Get current authenticated user profile

Auth:Session cookie
Example Response:
{ "id": "usr_abc123", "name": "John Doe", "email": "[email protected]", "role": "user" }
POST/api/trpc/auth.logout

End current session and clear authentication cookie

Auth:Session cookie
Example Response:
{ "success": true }

Webhooks (Coming Soon)

Subscribe to real-time events: campaign status changes, budget alerts, AI recommendation triggers, and performance threshold notifications. Configure endpoints in your dashboard settings.

SDKs & Libraries (Coming Soon)

Official client libraries for JavaScript/TypeScript, Python, and PHP. Type-safe API access with auto-generated types from our tRPC schema. Available via npm, pip, and composer.

Integration Ecosystem

Connect Bizowl to your existing tools via our API or upcoming native integrations.

ZapierMake.comn8nSlackGoogle SheetsNotionHubSpotShopify

Native integrations coming Q3 2026. Use our REST API for custom integrations today.

API documentation last updated: 10 May 2026

Questions? Contact [email protected] or visit our SLA page.

Get AI marketing insights weekly

Join 2,000+ marketers getting actionable AI tips, platform updates, and strategy guides every Thursday.