Event Code 121 - Card Creation Failure

The 121 event code is used to send out a Card Creation Failure notification.

Card creation requests are processed asynchronously. When you submit a request to the endpoint, Thredd returns an immediate 202 Accepted response containing a unique messageId.

If background processing fails after the 202 Accepted response has been issued, Thredd will send an Event Delivery System (EDS) webhook notification with event code 121 (Card Creation Failure).

Webhook Notification for Card Creation Failure

If the card creation is unsuccessful, Thredd will send an Event Delivery System (EDS) webhook notification with event code 121 (Card Creation Failure).

Event Summary

Webhook Payload Example

When an asynchronous card creation request fails, Thredd delivers the following Event Code 121 to your configured webhook URL:

{
  "context": {
    "notificationId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "eventCode": 121,
    "eventVersion": "v1",
    "notificationTime": "2026-10-20T12:00:00Z"
  },
  "payload": {
    "messageId": "e1cb2235-d65c-495f-b792-d231f1f7b1e2",
    "reason": "The provided reference number is already in use."
  }
}