Publishing

External notification creation and publishing (Processor service)

Publish notifications

post

https://notifications.decentraland.orghttps://notifications.decentraland.zone

/notifications

Creates and stores new notifications. This endpoint is used by external services to publish notifications to users. Notifications are validated, stored in the database, and if the user has email notifications enabled, an email is sent. Available only in the Processor service.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer token authentication using a shared API key (NOTIFICATION_SERVICE_TOKEN). Used for service-to-service communication and external notification publishing.

Example:

Authorization: Bearer <api-key>

Bodyobject[]

application/json

typestringRequired

Notification type (must be a valid NotificationType enum value)

Example: worlds_access_restored

addressstringRequired

Ethereum address of the recipient user

Pattern: ^0x[a-fA-F0-9]{40}$

eventKeystringRequired

Unique identifier for this event (used for deduplication)

Example: 0xf17828d89d6056215d65451fc61a802f5054fa01aa0acc39b644dc191086dd8b

timestampinteger · min: 1672531200000Required

Unix timestamp in milliseconds when the event occurred (must be after 2023-01-01)

Example: 1701379983000

Responses

204

Notifications published successfully

400

Invalid request body or validation error

application/json

401

Unauthorized - missing or invalid API key

application/json

post

/notifications

HTTPcURLJavaScriptPython

POST /notifications HTTP/1.1
Host: notifications.decentraland.org
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 208

[
  {
    "type": "worlds_access_restored",
    "address": "text",
    "eventKey": "0xf17828d89d6056215d65451fc61a802f5054fa01aa0acc39b644dc191086dd8b",
    "metadata": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "timestamp": 1701379983000
  }
]

No content