Changelog

Public API v1 (current)

  • REST under /public/v1 — credits, accounts, campaigns, leads, send, LinkedIn lookup/search
  • Outbound webhooks (4 events); manage subscriptions in /api-mcp
  • MCP tools mostly 1:1 with REST (https://mcp.scaliq.ai); MCP-only search_linkedin_until paces multi-page POST /linkedin/search

Recent additions (non-breaking)

  • MCP paced LinkedIn search: tool search_linkedin_until (targetCount max 50, resume cursor, ~90s budget). Prefer over one-page search_linkedin when the user asks for a count of prospects. No new REST route.
  • LinkedIn account lifecycle: POST /accounts/connect-link, POST /accounts/:id/disconnect-for-reconnect, POST /accounts/:id/reconnect-link, DELETE /accounts/:id (0 credits; 30/min shared control writes). MCP: create_linkedin_connect_link, disconnect_linkedin_for_reconnect, create_linkedin_reconnect_link, delete_account. User still completes hosted LinkedIn login in the browser. Runbook gate: Agent setup.
  • One-prompt setup: GET /setup + MCP get_setup_status (account / template / campaign counts + credits). Runbook: Agent setup.
  • MCP OAuth Sign-in: /mcp-authorize shows Allow access? (client name + redirect host) before minting; Deny exits without a key. Paste fallback: GET /oauth/paste. Workspace key name MCP OAuth is reserved on /api-mcp create.
  • Outreach writes (manual agents / tags / campaigns): create/list/get/update/delete templates (manual only create/update), assign template, create/rename/delete campaigns, tags create/update, account daily caps, lead static preview, delete lead.
  • Lead batch ops: POST …/leads/batch-update (tag/exclude, max 100, 0 credits, 6/min), POST …/leads/batch-delete (permanent delete, max 100, 0 credits, no refund, 10/min), GET …/leads?excluded=true. MCP tools update_leads_batch / delete_leads_batch (destructiveHint on delete).
  • Insights: GET /activity (recent outreach events), GET /insights/overview (sampled campaign ranking + last-reply highlights). Lead list/detail add ISO repliedAt / lastInboundMessageAt / taggedAt and optional sort. MCP tools get_recent_activity / get_insights_overview.
  • POST /campaigns/lookalike — async Lookalike campaign create/extend (Lookalike allowance). Optional countries (ISO alpha-2) person location filter. MCP tool create_lookalike_campaign. GET /credits adds lookalikeCredits / lookalikeTopUpCredits.
  • Signed webhook deliveries now also include a neutral X-Webhook-Signature header (same value as X-ScaliQ-Signature). Prefer it for new integrations; the ScaliQ-named header keeps working.
  • lead.tagged (and other outbound events) fill data.accountId from the lead’s account id, then fall back to the matching inbox chat’s account when the lead field is missing.
  • Outbound webhook signing uses a static shared secret: when you set a signing secret, ScaliQ sends X-ScaliQ-Signature: <that exact string> (works with n8n Header Auth). Previously this was an HMAC sha256= digest.
  • GET /accounts accepts limit / cursor and returns nextCursor. Existing callers that read accounts keep working; only workspaces with more than 50 accounts need to page.
  • 413 for request bodies over 128 KiB.
  • Idempotency on these 10 POST routes: add lead, leads batch, batch-update, batch-delete, create campaign, lookalike, create tag, create template, assign template, send message. If the key cannot be recorded → 503 with nothing performed (safe to retry the same key).

Future breaking changes will be listed here.