What is a WhatsApp timelock?

Definition

A timelock is a temporary hold WhatsApp places on a number's ability to start new conversations. Replies inside existing threads usually keep working, which is the giveaway. It lifts by itself after a period, and Wapito surfaces the expected time so a scheduler can wait rather than retry into it repeatedly.

In more depth

Timelocks are what happens before a ban. WhatsApp sees a number sending a burst of first messages to people who have never written to it, or collecting blocks and reports faster than a normal line would, and rather than removing the number it throttles the behaviour that triggered the alarm. Because ongoing conversations continue, the symptom is confusing from the inside: support threads work perfectly while every outbound campaign message is refused. The correct response is to stop, not to wait it out and resume the same pattern. A number that is timelocked twice for the same reason is on a short path to being banned outright, and no provider - Wapito included - can appeal that on your behalf, because the decision is WhatsApp's and the relationship is with the number's owner. Use the hold as a diagnostic: look at who you were messaging, whether they opted in, how fast the queue was draining, and whether the first message gave people an easy way to opt out.

In the Wapito API

On the wire it is the field until:

{
  "error": {
    "code": "reachout_timelocked",
    "details": {
      "until": "2026-09-16T08:00:00Z"
    }
  }
}

On the official Cloud API

The Cloud API has its own quality signals and can restrict or pause a phone number that accumulates negative feedback, so the underlying risk of over-messaging exists on the official platform too.

Wapito is an independent product. It is not affiliated with, endorsed by, sponsored by or certified by WhatsApp or Meta Platforms, Inc. WhatsApp is a trademark of Meta Platforms, Inc.

Related terms

Related

Try it on your own number

Create a channel, link a WhatsApp number by QR or pairing code, and call the API in a couple of minutes. The Sandbox plan is free and needs no card.