---
title: "createDigitalAccessKey"
method: POST
path: "/messaging/v1/orders/{amazonOrderId}/messages/digitalAccessKey"
tags: ["Messaging v1"]
---

# createDigitalAccessKey

`POST /messaging/v1/orders/{amazonOrderId}/messages/digitalAccessKey`

Sends a buyer a message to share a digital access key that is required to utilize digital content in their order.

**Usage Plan:**

| Rate (requests per second) | Burst |
| ---- | ---- |
| 1 | 5 |

The `x-amzn-RateLimit-Limit` response header contains the usage plan rate limits for the operation, when available. The preceding table contains the default rate and burst values for this operation. Selling partners whose business demands require higher throughput might have higher rate and burst values than those shown here. For more information, refer to [Usage Plans and Rate Limits](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).

## Path parameters

- `amazonOrderId` string, required

## Query parameters

- `marketplaceIds` string[], required

## Request body

- CreateDigitalAccessKeyRequest — The request schema for the `createDigitalAccessKey` operation.
  - `text` string — The text that is sent to the buyer. Only links that are related to the digital access key are allowed. Do not include HTML or email addresses. The text must be written in the buyer's preferred language, which you can retrieve from the `GetAttributes` operation.
  - `attachments` Attachment[] — Attachments that you want to include in the message to the buyer.
    - `uploadDestinationId` string, required — The identifier for the upload destination. To retrieve this value, call the Uploads API [`createUploadDestinationForResource`](https://developer-docs.amazon.com/sp-api/reference/createuploaddestinationforresource) operation.
    - `fileName` string, required — The name of the file, including the extension. This is the file name that will appear in the message. This does not need to match the file name of the file that you uploaded.

## Response `201`

The message was created for the order.

## Other responses

- `400` — Request has missing or invalid parameters and cannot be parsed.
- `403` — Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
- `404` — The resource specified does not exist.
- `413` — The request size exceeded the maximum accepted size.
- `415` — The request payload is in an unsupported format.
- `429` — The frequency of requests was greater than allowed.
- `500` — An unexpected condition occurred that prevented the server from fulfilling the request.
- `503` — Temporary overloading or maintenance of the server.

---

[API](https://skmtc.net/aws-samples/apis/a-content-management-v2020-11-01.md) · [All operations](https://skmtc.net/aws-samples/apis/a-content-management-v2020-11-01/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws-samples/a-content-management-v2020-11-01/revisions/815a5b6dbaa6/schema)