Skip to content

Routing Rules API

Last updated: March 19, 20267 min readAdvancedDeveloper

The Routing Rules API lets you programmatically manage consent forwarding rules and query decision audit trails.

Rule CRUD Operations

javascript
// Create rule
POST /api/routing-rules
{
  "name": "Block EU marketing",
  "conditions": { "jurisdiction": "gdpr", "consentState": { "marketing": false } },
  "actions": { "block": ["meta_capi", "tiktok"] },
  "priority": 10
}

// List rules
GET /api/routing-rules

// Update rule
PUT /api/routing-rules/:id

// Delete rule
DELETE /api/routing-rules/:id

Condition Types

javascript
{
  "jurisdiction": "gdpr",        // Regulatory regime
  "consentState": { "marketing": false }, // Specific consent values
  "gpcDetected": true,           // GPC signal present
  "domains": ["example.com"]     // Specific domains
}

Action Types

javascript
{
  "block": ["meta_capi"],     // Block these platforms
  "allow": ["ga4"],            // Only allow these platforms
  "transforms": {              // Modify payload before forwarding
    "stripPII": true
  }
}

Query Decisions

javascript
GET /api/routing-rules/decisions?from=2026-03-01&to=2026-03-18
GET /api/routing-rules/decisions/stats
Rules are evaluated in priority order (lowest number = highest priority). First matching rule wins per integration.

Was this article helpful?

Next

Platform Connector Reference

Related Articles

Server-Side Events

Configure Routing Rules

Set up rules to control which events are forwarded to which platforms.

Read more
Integrations

API Authentication

Create API keys, set authentication headers, understand rate limits, and handle errors.

Read more