Xtremepush

Datafly Signal delivers events to Xtremepush server-to-server using the External Event API (event hits). Each event can trigger a real-time Xtremepush campaign or workflow (email, push, SMS, web, in-app) and updates the matching user profile — with no client-side Xtremepush SDK in the page.

Prerequisites

Before configuring Xtremepush in Signal you need an active Xtremepush project and its App Token.

Configuration

Configure in Signal

datafly.identify("crm-12345", {
  email: "jane.doe@example.com",
  firstName: "Jane",
  lastName: "Doe"
});

API Endpoint

POST https://api.eu.xtremepush.com/api/external/hit/event

(or https://api.us.xtremepush.com/... for US projects)

Authentication is carried in the request body as the apptoken field. Each event is sent as a single JSON object. Xtremepush returns {"success": true, "code": 200} on acceptance.

A higher-throughput batch endpoint (/api/external/hit/events, up to 1,000 events per request) is also available; contact Datafly support if you need batching enabled.

Identity Signals

Xtremepush matches events to user profiles using the external user_id. Additional profile traits ride along in user_attributes and update the profile before any triggered campaign fires.

Consent

When your CMP consent is mapped, Signal can populate Xtremepush consent_preferences per channel. Consent group names are project-specific — confirm your actual group names in Xtremepush before relying on this mapping. Example structure:

"consent_preferences": {
  "email": { "Group Marketing": 1 }
}

1 = opt-in, 0 = opt-out.

Event Mapping

Signal uses GA4-style event names. The Default preset maps them to Xtremepush event names; everything else is dropped (defaults.action: drop).

Event properties land in the value object; identify traits land in user_attributes. To customise, edit the integration’s Field Mappings in the Management UI.

Example: Purchase event

Datafly.js call:

datafly.identify("crm-12345", { email: "jane.doe@example.com" });
 
datafly.track("Order Completed", {
  order_id: "ORD-001",
  revenue: 129.99,
  currency: "USD"
});

Xtremepush event hit sent by Signal:

{
  "apptoken": "YOUR_APP_TOKEN",
  "user_id": "crm-12345",
  "event": "purchase",
  "timestamp": "2026-06-06 11:36:00 +00:00",
  "user_attributes": {
    "email": "jane.doe@example.com"
  },
  "value": {
    "order_id": "ORD-001",
    "revenue": 129.99,
    "currency": "USD"
  }
}

Testing

1. In Signal, open the Event Debugger for your Xtremepush integration.
2. Trigger an event on your site (e.g. a purchase).
3. Confirm Signal received {"success": true, "code": 200} from Xtremepush.
4. In Xtremepush, open the user profile for the user_id you sent and confirm the event appears in the profile’s event/activity history.
5. If you have a campaign triggered by the event, confirm it fires.

Troubleshooting