---
url: /errors/queue_email_message_invalid_idempotency_key.md
---
# `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:

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

Response:

```json
{
  "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.