Skip to content
Shortcut: /, ⌘K or Ctrl+K

Delete a team

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

View as Markdown

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.

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. 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#