---
title: "POST /destinations"
method: POST
path: "/destinations"
---

# POST /destinations

`POST /destinations`

Create a notification destination such as Kinesis Data Streams that receive events and notifications from Managed integrations. Managed integrations uses the destination to determine where to deliver notifications.

## Request body

- object
  - `DeliveryDestinationArn` string, required — The Amazon Resource Name (ARN) of the customer-managed destination.
  - `DeliveryDestinationType` 'KINESIS', required — The destination type for the customer-managed destination.
  - `Name` string, required — The name of the customer-managed destination.
  - `RoleArn` string, required — The Amazon Resource Name (ARN) of the delivery destination role.
  - `ClientToken` string — An idempotency token. If you retry a request that completed successfully initially using the same client token and parameters, then the retry attempt will succeed without performing any further actions.
  - `Description` string — The description of the customer-managed destination.
  - `Tags` object — A set of key/value pairs that are used to manage the destination.

## Response `201`

Success

- CreateDestinationResponse
  - `Name` string — The name of the customer-managed destination.

## Other responses

- `480` — AccessDeniedException
- `481` — ValidationException
- `482` — InternalServerException
- `483` — ConflictException
- `484` — ThrottlingException

---

[API](https://skmtc.net/aws/apis/iot-managed-integrations.md) · [All operations](https://skmtc.net/aws/apis/iot-managed-integrations/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/iot-managed-integrations/versions/d043c13c812a/schema)