Skip to main content
WEBHOOK
The vl.card.code_generation.failed event indicates that Voucherify could not generate or assign a code to a Loyalty v2 card. The failure reason is available in data.result.details.
This page documents only the event data nested under data. See Introduction to webhooks for the shared webhook structure, and Workflows webhooks for the full Workflows webhook payload.
This event can trigger a workflow when Loyalty activity is configured with the Cards group and the vl.card.code_generation.failed activity type. If the workflow reaches a Webhook callout action, Voucherify sends a webhook to the action’s target URL. The example shows the content of data. It contains snapshots recorded with the activity. It is not wrapped in an activity property. data.card.code is normally null. It can contain an existing code when assignment fails because the card already has a code.

Body

application/json

Event data object schema for vl.card.code_generation.failed.

card
Loyalty Card · object
required

Loyalty v2 card snapshot recorded with the activity.

program
Loyalty Program Reference · object
required

Program data recorded with a card code-generation activity. Some program fields may be omitted if the program could not be loaded.

result
Loyalty Card Code Generation Failure · object
required

Details about a failed Loyalty v2 card code generation.

Response

Webhook accepted

Last modified on September 25, 2026