> ## Documentation Index
> Fetch the complete documentation index at: https://kb.aampe.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Send a Test Message

> Because we'd rather not send a million messages with typos

## How to Send a Test Message

### Step 1:  Add Test-Message Recipients

<Info>
  Test-message recipients only need to be added once. If you have your preferred test users from a previous message, feel free to skip this step.
</Info>

1. Go to **Account members > Test message settings** and click the **+ Add user** button.

   <img src="https://mintcdn.com/aameo/XQ9FDI4Q85SFYkZK/images/test-message/add-test-message-user.png?fit=max&auto=format&n=XQ9FDI4Q85SFYkZK&q=85&s=bc1aa520047e056c0ae8cccee9f846cb" alt="Add Test Message User Pn" width="2990" height="1462" data-path="images/test-message/add-test-message-user.png" />
2. This will open a menu for adding a test user.

   <img src="https://mintcdn.com/aameo/XQ9FDI4Q85SFYkZK/images/test-message/add-test-user-module.png?fit=max&auto=format&n=XQ9FDI4Q85SFYkZK&q=85&s=30f8a58c2a7e20d98fb936df81a72415" alt="Add Test User Module Pn" title="Add Test User Module Pn" style={{ width:"61%" }} width="1284" height="1286" data-path="images/test-message/add-test-user-module.png" />
3. Fill in the three required fields:
   * Receiver name: name of the recipient
   * Token:
     * Push notifications - this is the device token
     * Emails - this is the recipient's email address
   * Provider name: the message delivery partner
4. Click **Create user** to finish adding your test-message recipient.
5. (Optional) If you want to send a test message to several recipients all at once, click the **+ Add group** button.

   <img src="https://mintcdn.com/aameo/XQ9FDI4Q85SFYkZK/images/test-message/add-group-button.png?fit=max&auto=format&n=XQ9FDI4Q85SFYkZK&q=85&s=a18d5073559a5de71cdf6131b92355d4" alt="Add Group Button Pn" width="2990" height="1462" data-path="images/test-message/add-group-button.png" />

   Give your group a name and add any of your existing users to the group. You can also create new users and immediately add them to this group by adding their names and tokens in the appropriate fields.

   <img src="https://mintcdn.com/aameo/XQ9FDI4Q85SFYkZK/images/test-message/create-group-menu.png?fit=max&auto=format&n=XQ9FDI4Q85SFYkZK&q=85&s=34b85e54eea1fe067bea3171f2ff99d5" alt="Create Group Menu Pn" title="Create Group Menu Pn" style={{ width:"66%" }} width="1540" height="1420" data-path="images/test-message/create-group-menu.png" />

   Click the **Create new group** button to finish creating your group.

### Step 2:  Send a Test Message

1. Open your message
2. Click the **Send a Test Message** button at the top of the page

<img src="https://mintcdn.com/aameo/XQ9FDI4Q85SFYkZK/images/test-message/send-test-message-button.png?fit=max&auto=format&n=XQ9FDI4Q85SFYkZK&q=85&s=f7527b7dbca68a80de59499875e048a3" alt="Send Test Message Button Pn" width="2990" height="1462" data-path="images/test-message/send-test-message-button.png" />

3. Select the language and message elements for your test message. This can include a  [dataset](/user-guide/using-aampe/tools/datasets) row, images, or specific labels. You can also click the **Randomize** button to select a random message variant for your test message.\
   \
   When the message is ready, click the **Select test audience** button to advance.

   <img src="https://mintcdn.com/aameo/XQ9FDI4Q85SFYkZK/images/test-message/send-test-message-menu.png?fit=max&auto=format&n=XQ9FDI4Q85SFYkZK&q=85&s=8819905f3b701d3c47a523db43ae3da7" alt="Send Test Message Menu Pn" width="2990" height="1462" data-path="images/test-message/send-test-message-menu.png" />
4. Select your message recipients, either an individual user or a group. See [Step 1](/user-guide/using-aampe/messages-by-channel/send-test-message#step-1:-add-test-message-recipients) if you need to add a new user or group.

<img src="https://mintcdn.com/aameo/XQ9FDI4Q85SFYkZK/images/test-message/send-test-message-audience.png?fit=max&auto=format&n=XQ9FDI4Q85SFYkZK&q=85&s=11ab83b5b33400da175eb090b77f2407" alt="Send Test Message Audience Pn" width="2990" height="1462" data-path="images/test-message/send-test-message-audience.png" />

5. Click the **Send test message** button to deliver your message.

### What is My Device Token?

If you're unsure how to get your device token (often the case for push notifications)...

* Click the **"Need help getting this?"** link in the test message window
* This will automatically send a request to our team at [developer@aampe.com](mailto:developer@aampe.com), and we'll assist you directly
