HomeGuidesAPI Reference
Submit Documentation FeedbackJoin Developer CommunityOptimizely GitHubOptimizely NuGetLog In

You can select a specific mailing by its internal name or search your mailings using the **bmPattern** parameter. If more than one mailing matches the pattern, the latest one is selected. Also, if you only specify the recipient ID, the latest mailing is displayed.

Use this operation, for example, to create a link to the latest newsletter. This link can be used in confirmation emails or on your website. Unlike other operations, this one always performs forwarding to a web page, where the online version of the mailing is shown. Thus, no [bmUrl](🔗) parameters have to be transmitted.

This operation is available in the mail and the form service.


Never use this HTTP API request directly on a web page or in a mailing. HTTP API requests of the form service must always be executed by the server without exposing the used source code to others. To use HTTP operations in mailings, use the mail service of the HTTP API (see [Mail service](🔗)).


NameMandatoryDefault valueDescription
bmRecipientIdyes/noThe ID of the new recipient (usually the email address)<br><br>If used in the mail service, this parameter is not mandatory (the email address is sent anyway). If used in the form service, the parameter is mandatory.
bmPatternnoWith the pattern parameter, you can search for mailings that match this pattern. The pattern refers to the internal names of the mailings.<br><br>You can use wildcards to define a pattern. Use a question mark ? for a single character and \* for several characters. If more than one mailing is found, the latest one is selected.
bmMailingIdyes/noThis parameter explicitly transmits the ID of the mailing you want to display. If **bmPattern** and **bmMailingId** are transmitted, the **bmMailingId** has priority.<br><br>If used in the mail service, the parameter is mandatory.

**Return values**

okRecipient forwarded to the online version of the email
missing\_idThe recipient with the given **bmRecipientId** does not exist in the recipient list, or no appropriate mailing was found.
wrong\_tagAuthorization failed.<br><br>Error codes:<br><ul><li>501=wrong authentication tag</li>

<li>502=wrong request IP</li> <li>503=wrong request method</li> <li>504=wrong protocol</li> <li>505=wrong recipient list</li> <li>506=wrong action</li> <li>507=action not found</li></ul><br>**Tip**: If a verification of the authentication tag does not solve the problem, contact [customer support](https://webhelp.episerver.com/latest/en/campaign/support/customer-support.htm "Customer support"). | | system\_error | A general error occurred. |

**Example 1**

The recipient of the email is forwarded to the last mailing sent by the same client. **Example 2**

The recipient with the ID _[email protected]_ is redirected to the last mailing sent by the same client whose internal name starts with _special_.