> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](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).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` 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>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
