Developers

API reference

Bearer-authenticated /api/v1 for Pro and Agency orgs. Machine-readable OpenAPI: /openapi/v1.json.

Authentication

Create a key under Dashboard → Developers (Pro/Agency). Send it on every request:

Authorization: Bearer apk_…

Missing, revoked, or FREE-plan keys return 401 with {"error":"Unauthorized"}.

Endpoints

Method	Path	Purpose
GET	/api/v1	Org summary + counts
POST	/api/v1	Action dispatch via JSON `action`

GET /api/v1

Returns organization metadata and brand/post/engagement/lead counts.

curl -H "Authorization: Bearer apk_..." \
  https://YOUR_HOST/api/v1

POST /api/v1 actions

create_post

Create a draft calendar post (optional video asset).

curl -X POST -H "Authorization: Bearer apk_..." \
  -H "Content-Type: application/json" \
  -d '{ "action": "create_post", "brandId": "BRAND_ID", "topic": "Spring launch teaser", "asVideo": false }' \
  https://YOUR_HOST/api/v1

generate_week

Generate a week of scheduled drafts for a brand.

curl -X POST -H "Authorization: Bearer apk_..." \
  -H "Content-Type: application/json" \
  -d '{ "action": "generate_week", "brandId": "BRAND_ID", "postsPerWeek": 5 }' \
  https://YOUR_HOST/api/v1

ingest_engagement

Ingest a comment/DM/mention (idempotent on platform + externalId).

curl -X POST -H "Authorization: Bearer apk_..." \
  -H "Content-Type: application/json" \
  -d '{ "action": "ingest_engagement", "brandId": "BRAND_ID", "type": "COMMENT", "platform": "INSTAGRAM", "content": "How much does this cost?", "authorName": "Alex", "authorHandle": "@alex", "externalId": "ig_comment_123", "processNow": true }' \
  https://YOUR_HOST/api/v1

list_leads

List leads with optional status/brand filters and cursor pagination.

curl -X POST -H "Authorization: Bearer apk_..." \
  -H "Content-Type: application/json" \
  -d '{ "action": "list_leads", "status": "NEW", "limit": 50 }' \
  https://YOUR_HOST/api/v1

Unknown action values return 400 {"error":"Unknown action"}. Agent and validation failures also return 400 with an error message.

Zapier

The Zapier Partner app uses the same Bearer key and wraps these actions. Prefer the invite on Developers when available; Catch Hook outbound webhooks remain supported for lead events.

Spec: OpenAPI 3.1 JSON · Manage API keys