# Create a Messaging Template

<a href="https://pxa.impact.com/student/activity/1087847?sid=0c0e3e5c-54c9-4435-9bee-ebcdccb7f292&#x26;sid_i=0?utm_source=app.impact.com&#x26;utm_medium=owned-platform&#x26;utm_content=eng-250&#x26;utm_campaign=help-center" class="button primary">Take the PXA course</a>

Use *Messaging templates* as a way to reach out to partners when you send content, dynamic fields, and insert signup links.

#### Create a messaging template

1. From the left navigation menu, select ![](/files/CDnwOBeIdds9r3Z6zTnO) **\[Engage] → Partners** → **Automation** → **Messaging Templates**.
2. In the upper-right corner, select **Create Messaging Template**.
3. If you want to apply an existing template, ![](/files/OoA2qxPalfCYKZvmxuU6) **\[Toggle on]** **Messaging Template** and select an existing messaging template from the ![](/files/jA6jLZ1RleK5VI2zmvap) **\[Drop-down menu]** **Select Template**.
4. Enter your messaging template details:

   | Field         | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
   | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   | Template Name | This will be the name you select when using the template.                                                                                                                                                                                                                                                                                                                                                                                                                             |
   | Send from     | This is the *from* name that recipients will see when they receive the template.                                                                                                                                                                                                                                                                                                                                                                                                      |
   | Reply to      | This is the email address that partners will contact when they reply to this template                                                                                                                                                                                                                                                                                                                                                                                                 |
   | Cc/Bcc        | <p><img src="/files/OoA2qxPalfCYKZvmxuU6" alt=""> <strong>\[Toggle on]</strong> to include a Cc or Bcc email recipient in addition to the partners in your chosen segment.</p><p>• You can add 1 email address to the <strong>Cc</strong> field and 1 to the <strong>Bcc</strong> field.</p><p>• Any email address added as a CC or BCC will receive a copy of every email sent to partners in the selected segment. The number of emails may vary depending on the segment size.</p> |
   | Subject       | The subject of the template.                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
   | Content       | <p>Enter the content of your template in the provided text editor.</p><p>• The <em>Content</em> section will already be populated if you have chosen to add an existing template.</p>                                                                                                                                                                                                                                                                                                 |
5. Optionally, **Insert signup link** to one of your template terms. This will add a **Join my program** button that acts as a sign up link to your template terms.
6. Optionally, **Insert other dynamic token** fields into your newsletter. You can see the dynamic fields available by selecting the ![](/files/cKusrCJQ0JNXi9xfpk7d) **\[Expand]** icon to the right of the option.
   * See the *Dynamic fields reference* below for more info about these fields.

<details>

<summary>Dynamic fields for newsletter</summary>

Select **Insert** to populate your template with relevant information (such as a partner’s name, or the current date) in your template.

{% hint style="warning" %}
**Attention:** Tokens are case sensitive. Do not place any formatting within special tokens (for example,`{lastName}` is valid but, `{LastName}` is not.
{% endhint %}

| Token                | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `{adcode_<adid>}`    | <p>Populates with the full ad listing of the specified <code>\<adid></code> value (e.g., <code>{adcode\_\<replace\_with\_ad\_id>}</code>).<br></p><p><strong>Ad code limitations</strong><br>The number of ad codes you can use per template is limited by the number of audience members that are part of your template.<br><br><strong>Number of Adcodes/Limit</strong></p><p>Maximum of 1 — up to 60,000 partners<br>Maximum of 5 — up to 30,000 partners<br>Maximum of 10 — up to 20,000 partners<br>Maximum of 20 — up to 5,000 partners</p> |
| `{mpid}`             | Populates with the ID value of the partner’s account (e.g., 98765).                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `{mpname}`           | Company name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `{firstName}`        | Populates with the first name of the partner (e.g., John).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `{lastName}`         | Populates with the last name of the partner (e.g., Doe).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `{currentDay}`       | Populates with the current date (e.g., January 19, 2038).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `{currentTime}`      | Populates with the full date in ISO format (e.g., 19-Jan-2038 03:14:08 UTC).                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `{currentMonthYear}` | Populates with the current month and year (e.g., January, 2038).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `{unsubscribeUrl}`   | URL to unsubscribe from the template.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `{programName}`      | The program name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `{programLogoSrc}`   | The source URL of the program logo.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |

</details>

7. Select **Preview** for a preliminary display of the segment. Once you're happy with the preview, select **Done** or **Send test email**.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/reach-out-to-partners/messaging-templates/create-a-messaging-template.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
