Mapp Engage: New REST API Endpoints for CMS, Coupons and Related Data

Next

19 November 2026 The Mapp Engage REST API has new endpoints for CMS content, coupon lists and Related Data. Integrations can now build emails from the email templates in your Mapp Engage CMS, manage coupon lists and look up Related Data sets without manual steps in the Mapp Engage interface. Nothing changes in the interface, and you only need to act if you want to use the new endpoints.


Manage CMS Content

  • Manage CMS objects. For blocks, frameworks, templates and messages, you can find, read, create, update, copy and delete objects. The find endpoints return results page by page and filter by text such as the name. For blocks and frameworks, you can also filter by content type (email, form, in-app, microsite). See Find CMS blocks as a starting point.

  • Build from templates. Create a template from a framework and a message from a template, the same way as in the interface.

  • Render content. Render a block with your own variable values, or render a template or message to get its final HTML. You can also render message content without saving it, to check that it renders correctly.

  • Create draft and prepared emails. POST /draftmessage/createFromCms creates a draft email from a CMS message. The draft is not assigned to a group yet. POST /preparedmessage/createFromCms creates a prepared message that is ready for sendout, for the group assigned to the CMS message. If you set groupId, it overrides that group. Neither endpoint sends the email. To send it, use the existing endpoints, for example Send a prepared message.

Warning

The CMS update endpoints replace the whole object. Fields that you leave out of the request are cleared, including the content. Read the object with the get endpoint first, change what you need and send the complete object back.


More New Endpoints

  • Coupon lists. Create, find, read, update, archive and restore coupon lists, and get the number of free, locked and total codes. You can also check whether a specific code is free, locked or not found, without reserving it. The endpoints do not upload coupon codes and do not return code values. To add codes to a list, import them in the interface or with an automation, see Create and Manage Coupon Lists. For the endpoints, start with Find coupon lists.

  • Related Data sets. List the Related Data sets that the API user can see, filtered by name or status, and get the columns of a data set. Integrations can look up data set and column names without the interface, for example before they read records by key.


Availability

The endpoints are available now in the Mapp Engage REST API. All endpoints require API version v19. Each area uses its existing permissions: the API user needs the CMS permissions for the CMS endpoints and the coupon permissions for the coupon list endpoints, see Permissions & Roles (CMS Email). The Related Data endpoints only return the data sets that the API user is allowed to see. Check which API users have CMS permissions, because they can now also change and delete CMS objects through the API. For how blocks, frameworks, templates and messages relate to each other, see CMS Email in Mapp Engage.