Datablow API Reference

🔑

Authentication

All API requests must include your API key in the x-api-key request header. You can generate API keys from the API Keys tab in your Datablow dashboard. Keys take the format db_live_....

GET /api/auth/verify Verify API Key

🟢 Authenticated via x-api-key header

Test that your API key is valid and active. Use this as the authentication test endpoint in ViaSocket, Zapier, Make, or any integration platform.

cURL Example

curl -X GET "https://tracking.datablow.com/api/auth/verify" \
  -H "x-api-key: db_live_your_key_here"

Response

{ "valid": true, "user": "user@example.com", "plan": "growth" }

📡

Webhook Receiver

Send offline conversion events to Datablow pipelines. Datablow automatically routes them to Meta CAPI, Google Ads, TikTok, Snapchat, and other ad platforms. All PII (email, phone) is auto-hashed SHA-256 server-side.

POST /api/offline-webhook/:pipeline_id Send Conversion Event

🟢 No auth required — pipeline_id is the secret

Send a conversion event to a specific Datablow pipeline. The pipeline ID is found in your dashboard under Offline Conversions. PII fields are automatically hashed before forwarding to ad platforms.

Path Parameters

Parameter	Type	Required	Description
pipeline_id	string	Required	Your Datablow pipeline UUID

Body Parameters

Field	Type	Required	Description
event_name	string	Required	e.g. Purchase, Lead, CompleteRegistration
email	string	Optional	Customer email — auto-hashed SHA-256
phone	string	Optional	E.164 format — auto-hashed SHA-256
first_name	string	Optional	Auto-hashed before forwarding
last_name	string	Optional	Auto-hashed before forwarding
value	number	Optional	Conversion value (e.g. 99.99)
currency	string	Optional	ISO 4217 currency code (e.g. USD)
order_id	string	Optional	Unique order or transaction ID
custom_data	object	Optional	Any additional metadata to forward

cURL Example

curl -X POST "https://tracking.datablow.com/api/offline-webhook/YOUR_PIPELINE_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "event_name": "Purchase",
    "email": "customer@example.com",
    "phone": "+14155551234",
    "value": 99.99,
    "currency": "USD",
    "order_id": "ord_abc123"
  }'

Response

{ "message": "Event processed successfully", "deliveries": [{ "platform": "meta", "status": "ok" }] }

Supported event_name values

PurchaseLeadCompleteRegistrationAddToCartInitiateCheckoutViewContentSearchContactSubscribeAddToWishlistCustomEvent

🔗

Pipelines

Pipelines define the routing rules for offline conversion events. Each pipeline connects a data source (e.g. your CRM or ViaSocket) to one or more ad platforms (Meta, Google Ads, TikTok).

GET /api/pipelines List Pipelines

🔑 Requires x-api-key header

Returns all offline conversion pipelines for your organization.

cURL Example

curl "https://tracking.datablow.com/api/pipelines" \
  -H "x-api-key: db_live_your_key_here"

Response

[{ "id": "pipe_...", "name": "My CRM Pipeline", "status": "active", "sourceCRM": "viasocket", "createdAt": "..." }]

POST /api/pipelines Create Pipeline

🔑 Requires x-api-key header

Create a new offline conversion pipeline.

Body Parameters

Field	Type	Required	Description
name	string	Required	Human-readable pipeline name
sourceCRM	string	Optional	CRM source: viasocket, salesforce, hubspot, etc.
metaPixelId	string	Optional	Meta Pixel ID for CAPI delivery
metaAccessToken	string	Optional	Meta CAPI access token

cURL Example

curl -X POST "https://tracking.datablow.com/api/pipelines" \
  -H "x-api-key: db_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "name": "My ViaSocket Pipeline", "sourceCRM": "viasocket" }'

Response

{ "id": "pipe_...", "name": "My ViaSocket Pipeline", "webhookUrl": "https://tracking.datablow.com/api/offline-webhook/pipe_..." }

GET /api/pipelines/:id/stats Pipeline Stats

🔑 Requires x-api-key header

Get detailed event delivery statistics for a specific pipeline.

cURL Example

curl "https://tracking.datablow.com/api/pipelines/pipe_abc123/stats" \
  -H "x-api-key: db_live_your_key_here"

Response

{ "received": 1247, "delivered": 1230, "failed": 17, "last24h": 84, "successRate": 98.6 }

DELETE /api/pipelines/:id Delete Pipeline

🔑 Requires x-api-key header

Permanently delete a pipeline and all its associated event logs.

cURL Example

curl -X DELETE "https://tracking.datablow.com/api/pipelines/pipe_abc123" \
  -H "x-api-key: db_live_your_key_here"

Response

{ "message": "Trigger pipeline deleted successfully." }

📦

Containers

sGTM (Server-side Google Tag Manager) containers running on the Datablow infrastructure. Each container gets a unique subdomain and dedicated Docker instance.

GET /api/containers List Containers

🔑 Requires x-api-key header

Returns all sGTM containers provisioned for your account, including status, domain, and container ID.

cURL Example

curl "https://tracking.datablow.com/api/containers" \
  -H "x-api-key: db_live_your_key_here"

Response

[{ "id": "cont_...", "name": "My GTM Container", "domain": "gtm.mysite.com", "status": "running", "port": 10001 }]

❤️

System Health

Uptime monitoring and health check endpoints. Use these in your load balancer, uptime robot, or monitoring dashboards.

GET /healthz Health Check

🟢 No auth required

Simple health check endpoint for load balancers and uptime monitoring tools. Returns 200 OK if the server is running.

cURL Example

curl "https://tracking.datablow.com/healthz"

Response

{ "status": "ok", "uptime": 3847.21 }