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

# POST /destinations

`POST /destinations`

Creates a new destination that maps a device message to an AWS IoT rule.

## Request body

- object
  - `Name` string, required — The name of the new resource.
  - `ExpressionType` 'RuleName' | 'MqttTopic', required — The type of value in <code>Expression</code>.
  - `Expression` string, required — The rule name or topic rule to send messages to.
  - `Description` string — The description of the new resource.
  - `RoleArn` string, required — The ARN of the IAM Role that authorizes the destination.
  - `Tags` Tag[] — The tag to attach to the specified resource. Tags are metadata that you can use to manage a resource.
    - `Key` string, required — The tag's key value.
    - `Value` string, required — The tag's value.
  - `ClientRequestToken` string — Each resource must have a unique client request token. If you try to create a new resource with the same token as a resource that already exists, an exception occurs. If you omit this value, AWS SDKs will automatically generate a unique client request.

## Response `201`

Success

- CreateDestinationResponse
  - `Arn` string — The Amazon Resource Name of the new resource.
  - `Name` string — The name of the new resource.

## Other responses

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

---

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