# Delete a team

> Schedule a team's deletion, cancel it within 24 hours, and see what is removed and what is kept.

Deleting a team removes its Numbers, projects and member access. You confirm
your identity, then deletion waits 24 hours, during which any owner can cancel
it. After that it cannot be undone.

> **Warning**
>
> **Credits are lost.** The team's remaining credit balance is not refunded or
> moved to another team.

## Before you begin

- You must be an owner of the team.
- Your account must belong to at least one other team. Your final team can only
  be removed by deleting your personal account.
- Resolve anything that blocks deletion, such as an active subscription or a
  payment still processing. The Console lists them.
- If you have authenticator two-factor authentication, have the app ready.

## Schedule deletion

1. Open **Team settings** > **General** and select **Delete team**. You can
   also select **Delete team** from the team's menu under **Account** >
   **Overview**.
2. Review what the Console shows: every Number the team still has, with its
   project; the credit balance that will be lost; and anything that must be
   resolved first.
3. Type the team name exactly as shown.
4. Select **Email me a code** and enter the six-digit code sent to your account
   email. With authenticator two-factor authentication, also enter a current
   code from the app.
5. Select **Schedule deletion** within 5 minutes of confirming your identity.

Each confirmation authorizes one request for that team. If it expires or the
request is refused, confirm again. You can request up to five codes in 15
minutes, and a code stops working after five wrong attempts.

Every owner receives an email with the cancellation deadline, and a reminder
about 2 hours before it.

## While deletion is scheduled

The team stays visible, with a banner showing the deadline, and becomes
read-only:

- Requests that change the team, such as sending messages, creating API keys,
  launching campaigns or buying credits, return `409` with the code
  [`team_deletion_scheduled`](https://docs.polymorfa.com/api/errors#team-deletion-scheduled). This
  applies to team keys, project tokens and the Console. Reads keep working.
- Running campaigns stop sending and keep their progress.
- Automatic top-ups do not run.
- Numbers stay connected and keep receiving messages, and webhooks keep
  delivering. Recurring Number charges continue.

## Cancel deletion

Select **Cancel deletion** in the banner, or select **Delete team** again and
then **Cancel deletion**. Any owner can cancel, without confirming their
identity. The team is restored at once, and every owner gets an email naming
who cancelled. You do not need to pair Numbers again.

Polymorfa also cancels the deletion, and emails the remaining owners, if the
owner who scheduled it is removed, loses the owner role or is suspended before
deletion starts. To delete the team, an owner must schedule it again.

## What happens at the deadline

The deadline is 24 hours after confirmation. After it, deletion cannot be
cancelled, even while a payment is processing. Deletion starts once nothing
blocks it; the team stays read-only while it waits.

When deletion starts:

1. The team disappears for every member, including owners. Links to its Console
   pages open another team you belong to.
2. Its team keys and project tokens are rejected as invalid.
3. Each Number is deleted the way a single Number is: disconnected, its
   WhatsApp login and Cloud API connection removed, and its hosted message
   history and Cloud API service-window and pricing records erased.
4. Campaigns are cancelled and webhook delivery is turned off.
5. After every Number is cleaned up, the team and its member access are
   removed.

Deleting a Cloud API Number in Polymorfa does not delete the number or its
WhatsApp Business Account at Meta.

Billing records and the team's audit history are kept. If you need help with a
deletion that has started, contact support.

When Polymorfa deletes a team, for example at your request through support,
deletion starts at once, without the 24-hour window, and cannot be cancelled.

## See also

- [Manage teams and projects](https://docs.polymorfa.com/teams)
- [Delete your account](https://docs.polymorfa.com/teams/account-security#delete-your-account)
- [Review audit history](https://docs.polymorfa.com/teams/audit-history)
