Skip to main content

Sprint 347 โ€” API v2: RESTful API + Webhooks for External Integrations

ยท 2 min read

Pragma now ships a complete developer API โ€” REST endpoints, scoped API keys, real-time webhooks, and built-in documentation at /developer.

What's newโ€‹

API v2 โ€” RESTful Endpointsโ€‹

External tools and scripts can now talk directly to Pragma:

EndpointDescription
GET /api/v2/workspaceWorkspace info and stats
GET /api/v2/signalsList signals from the inbox
POST /api/v2/signalsIngest a new signal
GET /api/v2/leadsList leads (with pagination)
GET /api/v2/leads/{id}Get a single lead
POST /api/v2/leadsCreate a lead
GET /api/v2/contactsList contacts
GET /api/v2/contacts/{id}Get a single contact

Granular API Key Scopesโ€‹

Each API key gets exactly the permissions it needs:

  • signals:read / signals:ingest
  • leads:read / leads:write
  • contacts:read / contacts:write
  • deals:read
  • webhooks:read / webhooks:write

Webhooks โ€” Real-time Eventsโ€‹

When a webhook is registered, Pragma sends a POST immediately on these events:

  • signal.created โ€” new signal in inbox
  • lead.created / lead.updated
  • deal.updated
  • message.created
  • billing.activated

All webhooks are HMAC-SHA256 signed (X-Pragma-Signature) and retried up to 5 times on failure.

Developer API in Settingsโ€‹

Under Settings โ†’ Developer API you can directly in the browser:

  • Create API keys (with scope selection) and revoke them
  • Register webhooks with any URL and event selection
  • Securely copy new keys (shown once only)

Developer Docs at /developerโ€‹

Full API documentation with code examples, curl snippets, and Zapier integration guide.

Why this mattersโ€‹

API v2 is the foundation for Sprint 343 (Zapier Official App) and opens Pragma to the no-code ecosystem with 7,000+ Zapier apps and millions of Make users.