queue_email_message_invalid_idempotency_key

queue_email_message_invalid_idempotency_key

Description

The queued email idempotency key is blank or invalid.

HTTP Status

400 Bad Request

doc_url Format

The doc_url value is an absolute URL and changes by environment:

<docs-base-url>/errors/queue_email_message_invalid_idempotency_key

Typical Causes

• The X-Quarzo-Life-Idempotency-Key or Idempotency-Key header contains only whitespace.
• The idempotency key is longer than 255 characters.

Example

Request:

POST /v1/emailing/messages
Content-Type: application/json
X-Quarzo-Life-Idempotency-Key: "   "

Response:

{
  "errors": [
    {
      "code": "queue_email_message_invalid_idempotency_key",
      "message": "The provided idempotency key is invalid.",
      "doc_url": "https://docs.example.com/errors/queue_email_message_invalid_idempotency_key"
    }
  ]
}

How To Fix

1. Send a non-empty idempotency key with either header, or omit the header.
2. Retry the request.