API Documentation

Integrate SENTRUM data into your workflows. All endpoints require authentication via API key.

Authentication

Include your API key in the Authorization header. Generate keys at Settings → API Keys.

bash

curl -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  https://app.sentrum.co/api/export/csv?type=campaigns

Data Export

GET/api/export/csv

Export entity data as a CSV file. Supports campaigns, ad sets, ads, and creatives.

Parameters

typestringrequiredEntity type: campaigns, adsets, ads, creatives

workspacestringWorkspace slug (defaults to primary)

dateFromstringStart date (ISO 8601)

dateTostringEnd date (ISO 8601)

statusstringFilter by status (e.g. ACTIVE, PAUSED)

bash

# Export active campaigns from last 30 days
curl -H "Authorization: Bearer sk_live_xxx" \
  "https://app.sentrum.co/api/export/csv?type=campaigns&status=ACTIVE&dateFrom=2026-02-01&dateTo=2026-03-01" \
  -o campaigns.csv

javascript

const res = await fetch('/api/export/csv?type=campaigns&status=ACTIVE', {
  headers: { Authorization: 'Bearer sk_live_xxx' },
});
const csv = await res.text();

Webhooks

Configure webhooks at Settings → Alerts to receive real-time notifications.

POSTYour webhook URL

SENTRUM sends POST requests to your configured endpoint when events occur.

Event Types

anomaly.detectedA metric anomaly was detected (CPM spike, CPA drift, etc.)

budget.alertBudget pacing alert (overspend/underspend)

creative.fatigueCreative fatigue detected on an ad

sync.completeData sync completed for an ad account

report.readyA scheduled report has been generated

json

{
  "event": "anomaly.detected",
  "timestamp": "2026-03-04T05:30:00Z",
  "workspace": "my-workspace",
  "data": {
    "entityType": "campaign",
    "entityId": "123456789",
    "entityName": "Spring Sale - Prospecting",
    "metric": "cpm",
    "severity": "high",
    "currentValue": 42.50,
    "expectedValue": 28.00,
    "changePercent": 51.8,
    "message": "CPM spiked 52% above 7-day average"
  }
}

MCP Tool Definitions

SENTRUM exposes tools via the Model Context Protocol (MCP) for AI agent integration.

get_campaign_performanceRetrieve performance metrics for campaigns with date range filtering

analyze_creativeGet AI-powered creative analysis including hook rate, hold rate, and fatigue signals

get_anomaliesFetch active anomalies and diagnostic flags across the account

get_recommendationsGet AI-generated optimization recommendations

export_dataExport entity data in CSV or JSON format

get_budget_pacingCheck budget pacing and spend forecasts for active campaigns

Rate Limits

Free plan

60 requests/hour

Pro plan

600 requests/hour

Team plan

3,000 requests/hour

Enterprise

Custom