Webhook Alerts

Get instant HTTP POST notifications when events happen. React quickly to quest completions on Ethereum and Monad.

Event Structure

application/json

{
  "id": "evt_1Pj2x9L1a",
  "type": "quest.completed",
  "created": 1723849200,
  "data": {
    "user_address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
    "quest_id": "monad-early-adopter",
    "xp_awarded": 500,
    "transaction_hash": "0x..."
  },
  "network": "ethereum_mainnet"
}

Secure Your Endpoint

Actora signs every webhook request with a signature header. Always verify this using your Webhook Secret to make sure the event is from us.

Supported Event Types

Event Name	Description	Stability
quest.completed	Fired when a user successfully verifies all on-chain requirements.	Production
launchpad.joined	Triggered when a user stakes USDC for a campaign entry.	Production
xp.minted	Confirmation event for on-chain Soulbound Token minting.	Beta
security.rotation	Sent when API keys or Webhook secrets are rotated.	Testing

Fast Delivery

For Ethereum, we wait for 2 block confirmations before sending. For Monad, webhooks are sent in under 1 second.

Testing Tool

Use actora webhook test in the CLI to send a sample payload to your local environment.