# Configuration sets in AWS End User Messaging SMS
A *configuration set* is a set of rules that are applied when you send a message. For example, a configuration set can specify a destination for events related to a message. When SMS events occur (such as delivery or failure events), they are routed to the destination associated with the configuration set that you specified when you sent the message. You're not required to use configuration sets when you send messages, but we recommend that you do. If you don't specify a configuration set with an event destination, the API doesn't emit event records. These event records are a useful way to determine how many messages you sent, how much you paid for each one, and whether or not the message was received by the recipient.
Once you have created a configuration set you should add an [event destination](configuration-sets-event-destinations.md) to help monitor your message send and receive events and a [protect configuration](protect-configuration.md) to create allow rules to only send messages to the destinations you do business in.
**Topics**
+ [Create a configuration set](configuration-set-create.md)
+ [Edit a configuration set](configuration-set-edit.md)
+ [View all configuration sets](configuration-set-view.md)
+ [Delete a configuration set](configuration-set-delete.md)
+ [Manage tags for a configuration set](configuration-set-tags.md)
+ [Edit a configuration set protect configuration](configuration-set-edit-protect-configuration.md)
# Create a configuration set in AWS End User Messaging SMS
Use the AWS End User Messaging SMS console or AWS CLI to create a configuration set. After you have created a configuration set you should add an [event destination](configuration-sets-event-destinations.md#configuration-sets-event-destinations.title) and [protect configuration](protect-configuration.md#protect-configuration.title).
------
#### [ Creating a configuration set (Console) ]
To create a configuration set using the AWS End User Messaging SMS console, follow these steps:
1. Open the AWS End User Messaging SMS console at [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).
1. In the navigation pane, under **Configurations**, choose **Configuration sets** and then **Create configuration set**.
1. For **Configuration set name** enter a descriptive name for the configuration set.
1. Choose **Create configuration set**.
------
#### [ Creating a configuration set (AWS CLI) ]
You can use the [create-configuration-set](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/create-configuration-set.html) command to create a new configuration set.
```
$ aws pinpoint-sms-voice-v2 create-configuration-set \
> --configuration-set-name configurationSet
```
In the preceding command, replace *configurationSet* with the name of the configuration set that you want to create.
------
# Edit a configuration set in AWS End User Messaging SMS
To edit a configuration set using the AWS End User Messaging SMS console, follow these steps:
1. Open the AWS End User Messaging SMS console at [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).
1. In the navigation pane, under **Configurations**, choose **Configuration sets**.
1. On the **Configuration sets** page, choose the configuration set to edit.
1. Select the **Set settings** tab and then choose **Edit settings**.
1. In **List settings** do the following:
+ **Message type** choose either:
+ **Promotional** – Choose this option for sending marketing messages or messages promoting your business or service.
+ **Transactional** – Choose this option for sending time-sensitive messages, such as password resets or transaction alerts.
+ **Default sender ID** – Choose the default sender ID for the configuration set.
+ **Message feedback** – Choose to enable [Message feedback](message-feedback.md#message-feedback.title) for the configuration set.
1. Choose **Save changes**.
# View all configuration sets in AWS End User Messaging SMS
Use the AWS CLI to view your configuration sets.
------
#### [ List configuration sets (AWS CLI) ]
You can use the [describe-configuration-sets](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-configuration-sets.html) command to view information about the configuration sets in your AWS End User Messaging SMS account.
**To view a list of the configuration sets in your account using the AWS CLI**
+ At the command line, enter the following command:
```
$ aws pinpoint-sms-voice-v2 describe-configuration-sets
```
------
#### [ Describe a configuration set (AWS CLI) ]
You can use the [describe-configuration-sets](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-configuration-sets.html) command to view information about a configuration set in your AWS End User Messaging SMS account.
**To view information about specific configuration sets using the AWS CLI**
+ At the command line, enter the following command:
```
$ aws pinpoint-sms-voice-v2 describe-configuration-sets \
> --configuration-set-names configurationSet
```
In the preceding command, replace *configurationSet* with the name of the configuration set that you want to find the details of. You can also specify multiple configuration sets by separating the name of each configuration set with a space.
------
# Delete a configuration set in AWS End User Messaging SMS
Use the AWS End User Messaging SMS console or AWS CLI to delete a configuration set.
------
#### [ Deleting a configuration set (Console) ]
To delete a configuration set using the AWS End User Messaging SMS console, follow these steps:
1. Open the AWS End User Messaging SMS console at [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).
1. In the navigation pane, under **Configurations**, choose **Configuration sets**.
1. Select the **Configuration set** you want to delete and then choose **Delete**.
------
#### [ Deleting a configuration set (AWS CLI) ]
You can use the [delete-configuration-set](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/delete-configuration-set.html) command to delete a configuration set.
```
$ aws pinpoint-sms-voice-v2 delete-configuration-set \
> --configuration-set-name configurationSet
```
In the preceding command, replace *configurationSet* with the name of the configuration set that you want to delete.
------
# Manage tags for a configuration set in AWS End User Messaging SMS
Tags are pairs of keys and values that you can optionally apply to your AWS resources to control access or usage. Adding a tag to a resource can help you categorize and manage resources in different ways, such as by purpose, owner, environment, or other criteria. You can use tags to easily find existing resources, or to control which users can access specific resources.
------
#### [ Manage tags (Console) ]
Use the AWS End User Messaging SMS console to add, edit or delete a Tag.
**Add a Tag (Console)**
1. Open the AWS End User Messaging SMS console at [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).
1. In the navigation pane, under **Configurations**, choose **Configuration sets**.
1. On the **Configuration sets** page, choose the configuration set to add a tag to.
1. On the **Tags** tab, choose **Manage tags**.
1.
+ **Add a tag** – In **Manage tags**, choose **Add new tag** to create a new blank key/value pair.
+ **Delete a tag** – In **Manage tags**, choose **Remove** next to the key/value pair.
+ **Edit a tag** – In **Manage tags**, choose the **Key** or **Value** and edit the text.
1. Choose **Save changes**.
------
#### [ Manage tags (AWS CLI) ]
Use the AWS CLI to add or edit a Tag.
```
$ aws pinpoint-sms-voice-v2 tag-resource \
--resource-arn resource-arn \
--tags tags={key1=value1,key2=value2}
```
In the preceding example, do the following:
+ Replace *resource-arn* with the Amazon Resource Name (ARN) that you want to add the tags to.
+ Replace *key1* and *key2* with the keys of the tags that you want to add to the resource.
+ Replace *value1* and *value2* with the values of the tags that you want to add for the respective keys.
Use the AWS CLI to delete a Tag.
```
$ aws pinpoint-sms-voice-v2 untag-resource \
--resource-arn resource-arn \
--tag-keys tags={key1=value1,key2=value2}
```
In the preceding example, do the following:
+ Replace *resource-arn* with the Amazon Resource Name (ARN) that you want to remove the tag from.
+ Replace *key1* and *key2* with the keys of the tags that you want to remove.
+ Replace *value1* and *value2* with the values of the tags that you want to remove.
------
# Edit a configuration set protect configuration association in AWS End User Messaging SMS
To change a configuration set's associated protect configuration, you can use the AWS End User Messaging SMS console, the `AssociaterotectConfiguration` action in the AWS End User Messaging SMS and voice v2 API, or the `aws sms-voice associate-protect-configuration` command in the AWS CLI. This section shows how to change a configuration set's protect configuration using the AWS End User Messaging SMS console and the AWS CLI.
To learn more about protect configurations see [Using protect configurations in AWS End User Messaging SMS](protect-configuration.md).
------
#### [ Edit a configuration set's protect configuration association (Console) ]
1. Open the AWS End User Messaging SMS console at [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).
1. In the navigation pane, under **Configurations**, choose **Configuration sets**.
1. On the **Configuration sets** page, choose a configuration set.
1. On the **Configuration set details page** choose the **Protect configuration** tab and then **Edit settings**.
1. Under **Protect configuration management** for **Protect configuration**, choose the protect configuration to associate with the configuration set. This replaces the current protect configuration association. Choose **No association** to disassociate the configuration set from a protect configuration.
1. Choose **Save changes**
------
#### [ Edit a configuration set's protect configuration association (AWS CLI) ]
To change a configuration set's protect configuration association in the AWS CLI follow the direction in [Change a protection configuration association in AWS End User Messaging SMS](protect-configuration-edit-association.md) on the Edit a protect configuration association (AWS CLI) tab.
------