Overview

The Prosudos REST API lets you read marketing workspace data and trigger content workflows from your website, CRM, automation tools (n8n, Zapier, Make), or custom apps. Each API key is scoped to one business workspace.

Authentication

Create an API key in Developers → API keys (business owners only). Send it on every request using the Authorization header. Keys start with prosudos_ and are shown only once when created.

curl -s "https://www.prosudos.com/api/v1/me" \
  -H "Authorization: Bearer prosudos_YOUR_KEY"

Scopes

Available scopes when creating a key: • read • content:write • agents:run read — list business, agents, content, keywords content:write — queue AI-generated content agents:run — trigger agent runs (coming soon)

GET /api/v1/me

Returns the business workspace linked to your API key.

# Response
{
  "business": {
    "id": "clx…",
    "name": "Acme Inc.",
    "websiteUrl": "https://acme.com",
    "industry": "SaaS"
  },
  "scopes": ["read"]
}

GET /api/v1/agents

List AI agents for the workspace (type, schedule, active status, last run).

curl -s "https://www.prosudos.com/api/v1/agents" \
  -H "Authorization: Bearer prosudos_YOUR_KEY"

GET /api/v1/content

List content queue items. Optional query: status (QUEUED, PUBLISHED, …), platform, limit (max 200).

curl -s "https://www.prosudos.com/api/v1/content?status=QUEUED&limit=50" \
  -H "Authorization: Bearer prosudos_YOUR_KEY"

POST /api/v1/content

Queue AI-generated social content. Requires content:write scope.

# Request body
{
  "platform": "instagram",
  "instruction": "Promote our spring sale"
}

# Response: { "items": [ … ] }

GET /api/v1/keywords

List tracked SEO keywords with rank, volume, and difficulty when available.

curl -s "https://www.prosudos.com/api/v1/keywords" \
  -H "Authorization: Bearer prosudos_YOUR_KEY"

Scribe Clock integration

Organizations connected via Scribe Clock use server-to-server endpoints under /api/integrations/scribeclock/ with PROSUDOS_SCRIBECLOCK_SECRET — not user API keys. See your Scribe Clock admin for marketing connect.

Incoming webhooks (n8n)

For automation platforms, you can also use the n8n webhook at POST /api/webhooks/n8n with x-webhook-secret (INTERNAL_API_SECRET / N8N_WEBHOOK_SECRET). Contact support to wire agent callbacks.

Errors

401 — missing or invalid API key 403 — key valid but missing required scope 404 — resource not found 429 — rate limited (future)

Developer documentation