Event Forwarding

Endpoints for forwarding events from external sources

Forward Explorer Events

post

https://events-notifier.decentraland.orghttps://events-notifier.decentraland.zone

/forward

Forwards events from the Decentraland Explorer client. This endpoint processes and validates client-side events such as user movement, emotes, login events, and other in-world interactions.

Events are validated for:

• Signature authenticity using HMAC-SHA1

• AuthChain validation for user authentication

• Event structure and content validation

• User address verification

Supported event types:

• move_to_parcel: User movement between parcels

• used_emote: Emote usage events

• passport_opened: Passport interaction events

• walked_distance: Movement tracking

• vertical_height_reached: Height-based achievements

• logged_in: User login events

• logged_in_cached: Cached login events

Authorizations

SignatureAuth

x-signaturestringRequired

HMAC-SHA1 signature for event validation

Body

application/json

Explorer client event data

eventstringOptional

Event type identifier

Example: move_to_parcel

messageIdstringOptional

Unique message identifier

Example: msg_123456789

anonymousIdstringOptional

Anonymous user identifier

Example: anon_abc123

userIdstringOptional

User identifier (if available)

Example: 0x1234567890abcdef

timestampstring · date-timeOptional

Event timestamp

sentAtstring · date-timeOptional

When the event was sent

receivedAtstring · date-timeOptional

When the event was received

Responses

200

Event successfully processed and forwarded

application/json

okbooleanOptionalExample: true

400

Invalid event data

application/json

401

Authentication failed

application/json

post

/forward

HTTPcURLJavaScriptPython

POST /forward HTTP/1.1
Host: events-notifier.decentraland.org
x-signature: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 528

{
  "event": "move_to_parcel",
  "messageId": "msg_123456789",
  "anonymousId": "anon_abc123",
  "userId": "0x1234567890abcdef",
  "timestamp": "2026-04-02T15:02:16.328Z",
  "sentAt": "2026-04-02T15:02:16.328Z",
  "receivedAt": "2026-04-02T15:02:16.328Z",
  "context": {
    "auth_chain": "text",
    "dcl_eth_address": "0x1234567890abcdef",
    "session_id": "text",
    "realm": "main",
    "realm_url": "text",
    "dcl_renderer_type": "Desktop",
    "launcher_anonymous_id": "text",
    "ip": "text",
    "parcel": "text",
    "position": "text",
    "runtime": "text"
  },
  "properties": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

{
  "ok": true
}

Forward Web Events

post

https://events-notifier.decentraland.orghttps://events-notifier.decentraland.zone

/forward-web

Forwards events from web applications and analytics platforms. This endpoint processes web-based events such as page views, user interactions, and analytics data.

Events are validated for:

• Signature authenticity using HMAC-SHA1

• Event structure validation

• User context validation (if Ethereum address is present)

• Anonymous ID validation and flagging

This endpoint supports Segment-compatible web events and includes special handling for authentication events that link anonymous IDs to Ethereum addresses.

Authorizations

SignatureAuth

x-signaturestringRequired

HMAC-SHA1 signature for event validation

Body

application/json

Web event data

typestringOptional

Event type

Example: track

messageIdstringOptional

Unique message identifier

Example: msg_web_123456

anonymousIdstringOptional

Anonymous user identifier

Example: anon_web_abc123

userIdstringOptional

User identifier (if available)

Example: 0x1234567890abcdef

timestampstring · date-timeOptional

Event timestamp

sentAtstring · date-timeOptional

When the event was sent

receivedAtstring · date-timeOptional

When the event was received

originalTimestampstring · date-timeOptional

Original event timestamp

integrationsobjectOptional

Integration settings

projectIdstringOptional

Project identifier (for specific event types)

Responses

200

Event successfully processed and forwarded

application/json

okbooleanOptionalExample: true

validationPassedintegerOptional

Whether validation passed (1) or failed (0)

Example: 1

400

Invalid event data

application/json

401

Authentication failed

application/json

post

/forward-web

HTTPcURLJavaScriptPython

POST /forward-web HTTP/1.1
Host: events-notifier.decentraland.org
x-signature: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 587

{
  "type": "track",
  "messageId": "msg_web_123456",
  "anonymousId": "anon_web_abc123",
  "userId": "0x1234567890abcdef",
  "timestamp": "2026-04-02T15:02:16.328Z",
  "sentAt": "2026-04-02T15:02:16.328Z",
  "receivedAt": "2026-04-02T15:02:16.328Z",
  "originalTimestamp": "2026-04-02T15:02:16.328Z",
  "context": {
    "page": {
      "path": "text",
      "url": "text",
      "title": "text",
      "referrer": "text",
      "search": "text"
    },
    "userAgent": "text",
    "userAgentData": {},
    "locale": "text",
    "library": {
      "name": "text",
      "version": "text"
    },
    "timezone": "text",
    "ip": "text"
  },
  "traits": {
    "ethAddress": "0x1234567890abcdef",
    "chainId": 1
  },
  "integrations": {},
  "projectId": "text"
}

{
  "ok": true,
  "validationPassed": 1
}