---
title: "Delete Group"
slug: "jobs-delete-group"
description: "Learn how to permanently delete a group, manage member data, and adjust automations in your system effectively. Ensure no essential data is lost!"
status: "update"
updated: 2026-09-23T07:06:06Z
published: 2026-09-23T07:06:06Z
canonical: "docs.mapp.com/jobs-delete-group"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Group

This job was previously called: Delete Group.

This job deletes a specific group from the system. The group members lose their membership in the group. Member addresses and user profile data remain stored in the system.

## What Happens When a Group Is Deleted

Deleting a group is permanent. The following data is removed:

- Group-specific data, such as group attributes and member attributes
- Group statistics and reporting data

Group members lose their membership in the group. Member addresses and contact profile data remain stored in the system.

## References to the Group

The system checks where the group is used before it deletes it. Some references prevent the deletion, others are adjusted:

- Certain active scheduled message tasks **prevent** the deletion. In this case the job fails and the group is not deleted.
- Scheduled tasks, event rules and whiteboards that reference the group are **deactivated**.
- Prepared messages that reference the group are **deleted**.
- A campaign that belongs to the group is **deleted together with the group**, including its statistics, unless the campaign has been marked beforehand.

> [!CAUTION]
> Do not delete a group whose campaigns, prepared messages or statistics you still need. Automations that use the group are switched off as part of the deletion. Check where the group is used before you schedule this job.

## Use Case​

This job is often used to modify automations that have been created via the API. For example, API calls are used to automate group creation in the system. The automations created by the API are visible in the interface in the ​Time-based Automations Overview​ window. This job can be used to modify these automations.

## Basic Settings​

| **Title** | **Description** |
| --- | --- |
| **​Name​** | This input field defines the name of the automation. The name is used to identify the automation in the system. It appears on the ​Time-based Automations Overview​ window. The maximum length is 100 characters. |
| **​Description​** | This input field defines a description of the automation. The description makes it easier to identify the automation in the system. |
| **​Job​** | This input field defines the job. For a list of all available jobs, see [All Available Time-Based Jobs](/v1/docs/all-available-time-based-jobs)​. |

## Define Job​

This area defines the specific parameters of the job.

- **Group Name:** This field defines the group to be deleted. Use the ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/18a6b1ed-42de-453d-9b7d-f1ba73c8b473.png) symbol to search for a specific group.

## Schedule

| **​Schedule** | This button saves your changes and opens the ​Schedule Time-based Automation​ window. Here you define the date and time of execution. For more information, see [Schedule Time-Based Automation (window)​](/v1/docs/schedule-time-based-automation-window). |
| --- | --- |