> ## Documentation Index
> Fetch the complete documentation index at: https://www.marqeta.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Create webhooks

> Use the /webhooks/{eventtype} endpoint to send a batch of events to a webhook.

POST/webhooks/\{event\_type}

Use the `/webhooks/{event_type}` endpoint to send a batch of events to a webhook.

## Header parameter

| Fields | Description |
| - | - |
| req-sys-id string  Optional | Random pseudo-unique identifier of a request, used for troubleshooting between multiple parties. Usually a globally unique identifier (GUID). **Allowable Values:**  1–36 chars |

## URL path parameters

| Fields | Description |
| - | - |
| event\_type string  Required | Digital wallet token event type. **Allowable Values:**  `digitalwallettoken`, `digitalwallettokentransition` |

## Sample request body

Digital Wallet Token Webhooks

```json JSON expandable lines wrap theme={null}
{
  "digitalwallettokens": [
    {
      "token": "my_webhook_event_01",
      "event_type": "digitalwallettoken.provisioningrequest",
      "webhook_details": {
        "token": "my_provisioning_request_01",
        "card_token": "my_card_01",
        "state": "REQUEST_DECLINED",
        "fulfillment_status": "REJECTED",
        "issuer_eligibility_decision": "avs.decline",
        "created_time": "2025-09-11T00:20:23Z",
        "last_modified_time": "2025-09-11T00:20:23Z",
        "encrypted_data": {
          "card_data": {
            "primary_account_number": "41111199999",
            "expiration_date": {
              "month": "01",
              "year": "2024"
            }
          },
          "token_service_provider": {
            "token_reference_id": "DNITHE343434343459",
            "pan_reference_id": "V-123343434343434",
            "token_requestor_id": "40010083275",
            "token_requestor_name": "UNKNOWN",
            "token_type": "MERCHANT_CARD_ON_FILE",
            "token_eligibility_decision": "DECISION_GREEN"
          },
          "device": {
            "language_code": "eng"
          },
          "address_verification": {
            "street_address": "180 Grand Ave",
            "zip": "94612"
          }
        },
        "wallet_provider_profile": {
          "account": {
            "id": "40010083275",
            "email_address": "A11AAAA1A011C11111111111A1AA111F...."
          },
          "risk_assessment": {},
          "pan_source": "KEY_ENTERED"
        }
      }
    }
  ]
}
```

Digital Wallet Token Transition Webhooks

```json JSON expandable lines wrap theme={null}
{
  "digitalwallettokentransitions": [
    {
      "token": "my_webhook_event_02",
      "event_type": "digitalWalletTokenTransition.requested",
      "webhook_details": {
        "token": "my_digital_wallet_token_transition_01",
        "digital_wallet_token": {
          "token": "my_digital_wallet_token_01"
        },
        "type": "fulfillment.requested",
        "channel": "TOKEN_SERVICE_PROVIDER",
        "state": "REQUESTED",
        "fulfillment_status": "DECISION_GREEN",
        "reason": "Token creation",
        "reason_code": "21",
        "created_time": "2025-09-06T22:52:13Z"
      }
    },
    {
      "token": "my_webhook_event_03",
      "event_type": "digitalWalletTokenTransition.terminated",
      "webhook_details": {
        "token": "my_digital_wallet_transition_token_02",
        "digital_wallet_token": {
          "token": "my_digital_wallet_token_02"
        },
        "type": "fulfillment.requested",
        "channel": "TOKEN_SERVICE_PROVIDER",
        "state": "REQUESTED",
        "fulfillment_status": "DECISION_GREEN",
        "reason": "Token creation",
        "reason_code": "21",
        "created_time": "2025-09-06T22:52:13Z"
      }
    }
  ]
}
```


## Related topics

- [Create webhook](https://www.marqeta.com/docs/core-api/webhooks/create-webhook.md)
- [Webhooks Overview](https://www.marqeta.com/docs/core-api/webhooks.md)
- [Tokenization-as-a-Service Overview](https://www.marqeta.com/docs/core-api/tokenization-as-a-service.md)
- [About Webhooks](https://www.marqeta.com/docs/developer-guides/about-webhooks.md)
- [Create stop payment order](https://www.marqeta.com/docs/core-api/ach-receiving/stop-payment-orders/create-stop-payment-order.md)