23 September 2026 Integrations no longer need to know your group IDs in advance. Three new REST API endpoints let you look up the groups in your account, see whether an operation is currently running on one, and delete groups you no longer need.
What's New
Find groups.
GET /group/findreturns a paginated list of your groups with their IDs, names, categories and member counts, filtered and sorted as you need. Use it to resolve a group by name, to build a group selector in your own application, or to keep an external system in sync with your Engage groups.Get group lock status.
GET /group/getLockStatustells you whether an operation such as a segment transfer, an import or a sendout is still running on a group. Use it to sequence steps that must not overlap, for example to wait until a segment transfer has finished before you trigger a sendout.Delete groups.
POST /group/deletedeletes one or more groups in a single call and returns an individual result for every group ID you send. Use it to clean up groups that programmatic segment transfers created on the fly.
For parameters, response fields, result codes and the behaviour of each endpoint, see Managing Groups with the REST API.
Deleting a group affects more than the group itself. Automations that use it are deactivated, prepared messages that use it are deleted, and an unmarked campaign belonging to the group is deleted along with it. Read References to the Group before you automate deletions.
Availability
The three endpoints are available now to all Mapp Engage customers, from API version v19 onwards.