Axon

Send event and analytics data to Axon for data orchestration, dataset management, and centralised event collection.

⚠️

This integration is currently in beta. Configuration and behaviour may change.

Overview

The Axon integration delivers events server-side from Datafly Signal to your Axon instance. Events are written into a specified Axon dataset, enabling you to use Axon’s orchestration and processing capabilities on your website and app event data without deploying client-side Axon scripts.

Prerequisites

Create an Axon Account

Sign up for an Axon account at axon.dev if you don’t already have one. Note your Organisation ID, which is available in the Axon dashboard under Settings.

Create a Dataset

In the Axon dashboard, navigate to Datasets.
Create a new dataset to receive events from Signal.
Note the Dataset ID from the dataset settings page.

Generate an API Key

In the Axon dashboard, go to Settings > API Keys.
Create a new API key with write permissions for your target dataset.
Copy the API key immediately — it will not be shown again.

Configuration

Field	Type	Required	Description
`api_key`	secret	Yes	Your Axon API key for authenticating server-to-server event delivery.
`org_id`	string	Yes	Your Axon organisation ID, found in the Axon dashboard under Settings.
`dataset_id`	string	Yes	The Axon dataset ID to write events into.

Signal Setup

Management UI

Go to Integrations and open the Integration Library tab.
Find Axon or filter by Other.
Click Install and fill in the required fields:
- API Key: Your Axon API key
- Organisation ID: Your Axon org ID
- Dataset ID: The target dataset ID
Click Install Integration.

Management API

curl -X POST http://localhost:8084/v1/admin/integration-catalog/axon/install \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Axon",
    "variant": "default",
    "config": {
      "api_key": "your-api-key",
      "org_id": "org-abc-123",
      "dataset_id": "dataset-xyz-456"
    },
    "delivery_mode": "server_side"
  }'

Delivery

Events are delivered server-side from your Datafly Signal infrastructure directly to the Axon API. No client-side scripts are loaded for this integration.

Signal sends events in Axon’s expected format, including event type, properties, user identifiers, and context metadata.

Testing

Enable the integration and trigger events on your site (page views, custom events, etc.).
In the Signal Management UI, check the Integration Detail page for delivery status and any errors.
In the Axon dashboard, navigate to your dataset and verify that events are appearing.
Check event payloads in Axon to confirm that properties, user IDs, and timestamps are correct.

Troubleshooting

Problem	Solution
401 Unauthorized	Your API key is invalid or has been revoked. Generate a new key in the Axon dashboard and update the integration config.
403 Forbidden	The API key does not have write permissions for the specified dataset. Check key permissions in Axon.
404 Not Found	The `org_id` or `dataset_id` is incorrect. Verify both values in the Axon dashboard.
Events not appearing in Axon	Check the integration detail page in Signal for delivery errors. Ensure the dataset exists and has not been archived.
Timeout errors	The Axon API may be experiencing issues. Check the Axon status page for service status.
Duplicate events	Axon may deduplicate based on event ID. If you see duplicates, check whether retries are causing redelivery of already-processed events.

For full API documentation, see the Axon documentation.

Custom Webhook Google AJSID Segments