Skip to main content
WEBHOOK
wallet_action.earn_incentive_claim.failed
{
  "type": "wallet_action.earn_incentive_claim.failed",
  "wallet_action_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "wallet_id": "fmfdj6yqly31huorjqzq38zc",
  "action_type": "earn_incentive_claim",
  "status": "failed",
  "created_at": "2026-06-15T15:24:00.000Z",
  "failed_at": "2026-06-15T15:24:12.000Z",
  "chain": "base",
  "rewards": [
    {
      "token_address": "0x58D97B57BB95320F9a05dC918Aef65434969c2B2",
      "token_symbol": "MORPHO",
      "token_decimals": 18,
      "amount": "1000000000000000000"
    }
  ],
  "failure_reason": {
    "message": "Transaction execution reverted"
  },
  "steps": [
    {
      "type": "evm_transaction",
      "status": "reverted",
      "caip2": "eip155:8453",
      "transaction_hash": "0x2222222222222222222222222222222222222222222222222222222222222222",
      "failure_reason": {
        "message": "Transaction execution reverted"
      }
    }
  ]
}

Body

application/json

Payload for the wallet_action.earn_incentive_claim.failed webhook event.

​
type
enum<string>
required

The type of webhook event.

Available options:
wallet_action.earn_incentive_claim.failed
​
wallet_action_id
string
required

The ID of the wallet action.

​
wallet_id
string
required

The ID of the wallet involved in the action.

​
action_type
enum<string>
required

Type of wallet action

Available options:
swap,
transfer,
earn_deposit,
earn_withdraw,
earn_incentive_claim
​
created_at
string
required

ISO 8601 timestamp of when the wallet action was created.

​
chain
string
required

EVM chain name (e.g. "base", "ethereum").

​
rewards
EarnIncetiveClaimRewardEntry · object[] | null
required

Claimed reward tokens. Populated after the preparation step fetches from Merkl.

​
status
enum<string>
required

The status of the wallet action.

Available options:
failed
​
failure_reason
FailureReason · object
required

A description of why a wallet action (or a step within a wallet action) failed.

​
steps
(EVMTransactionWalletActionStep · object | EVMUserOperationWalletActionStep · object | SVMTransactionWalletActionStep · object | TVMTransactionWalletActionStep · object | ExternalTransactionWalletActionStep · object | CustodianTransactionWalletActionStep · object)[]
required

The steps of the wallet action. Completed steps will have transaction hashes; the failing step will have a failure_reason.

A wallet action step consisting of an EVM transaction.

​
failed_at
string
required

ISO 8601 timestamp of when the wallet action failed.

Response

200

Return a 200 status to indicate that the webhook was received successfully.