[{"data":1,"prerenderedAt":122},["ShallowReactive",2],{"pseo:errors:channel-locked":3,"highlight:error:channel-locked":116},{"cause":4,"code":5,"example":6,"faqs":10,"feature":17,"fix_steps":21,"http_status":25,"message":8,"protocol_aliases":26,"raised_by":27,"related":58,"retryable":95,"seo":96,"slug":113,"tier":114,"title":115,"updated":111,"url":107},"The channel has been placed on hold and every write is refused until the hold is lifted. A lock happens when a subscription payment fails, when abuse controls trip, or when an operator freezes a channel on request. Reads that do not change anything may still work, so your dashboard keeps rendering while sends stop. The details.reason field says which of those applies so support can act without guessing.","channel_locked",{"error":7},{"code":5,"message":8,"request_id":9},"This channel is locked.","req_01JRQ8F4X9N2K7YB3C5V6W8H0T",[11,14],{"a":12,"q":13},"Not immediately. The underlying session usually stays linked so that nothing has to be re-paired once the lock is lifted, but a lock that lasts long enough will run into WhatsApp's own inactivity unlink at roughly two weeks. Resolve the lock quickly to avoid re-pairing the phone.","Does a locked channel lose its WhatsApp session?",{"a":15,"q":16},"Inbound events may still be delivered so you do not lose the record of what happened, but outbound calls are refused. Treat a stream of inbound events with failing sends as a strong signal to check the channel status endpoint rather than to keep retrying.","Do webhooks keep arriving while a channel is locked?",{"name":18,"slug":19,"url":20},"Connect a Number","connect-number-qr-pairing","\u002Fwhatsapp-api\u002Fconnect-number-qr-pairing\u002F",[22,23,24],"Read details.reason and treat a billing lock differently from an abuse lock - only one of them is fixed with a card.","For a billing lock, update the payment method from the customer portal; the channel unlocks when the invoice clears.","For an abuse lock, stop the sending job first, then contact support with your request_id - restarting the job will not help.",403,[],[28,37,44,50],{"availability":29,"ban_risk":30,"method":31,"operationId":32,"path":33,"summary":34,"tag":35,"url":36},"ga","medium","POST","sendText","\u002Fmessages\u002Ftext","Send a text message","messages","\u002Fdocs\u002Fapi\u002Fmessages\u002Fsend-text\u002F",{"availability":29,"ban_risk":38,"method":31,"operationId":39,"path":40,"summary":41,"tag":42,"url":43},"high","createGroup","\u002Fgroups","Create a group","groups","\u002Fdocs\u002Fapi\u002Fgroups\u002Fcreate-group\u002F",{"availability":29,"ban_risk":30,"method":31,"operationId":45,"path":46,"summary":47,"tag":48,"url":49},"postTextStory","\u002Fstories\u002Ftext","Post a text status","stories","\u002Fdocs\u002Fapi\u002Fstories\u002Fpost-text-story\u002F",{"availability":29,"ban_risk":51,"method":52,"operationId":53,"path":54,"summary":55,"tag":56,"url":57},"low","GET","getChannel","\u002Fchannel","Get channel status and settings","channel","\u002Fdocs\u002Fapi\u002Fchannel\u002Fget-channel\u002F",{"glossary":59,"hub":69,"operations":70,"pillar":20,"siblings":79},[60,63,66],{"title":61,"url":62},"Pairing code","\u002Fglossary\u002Fpairing-code\u002F",{"title":64,"url":65},"QR linking","\u002Fglossary\u002Fqr-linking\u002F",{"title":67,"url":68},"Session","\u002Fglossary\u002Fsession\u002F","\u002Fdocs\u002Ferrors\u002F",[71,73,75,77],{"title":72,"url":36},"POST \u002Fmessages\u002Ftext",{"title":74,"url":43},"POST \u002Fgroups",{"title":76,"url":49},"POST \u002Fstories\u002Ftext",{"title":78,"url":57},"GET \u002Fchannel",[80,83,86,89,92],{"title":81,"url":82},"forbidden (403)","\u002Fdocs\u002Ferrors\u002Fforbidden\u002F",{"title":84,"url":85},"plan_required (402)","\u002Fdocs\u002Ferrors\u002Fplan-required\u002F",{"title":87,"url":88},"not_found (404)","\u002Fdocs\u002Ferrors\u002Fnot-found\u002F",{"title":90,"url":91},"not_on_whatsapp (404)","\u002Fdocs\u002Ferrors\u002Fnot-on-whatsapp\u002F",{"title":93,"url":94},"message_not_found (404)","\u002Fdocs\u002Ferrors\u002Fmessage-not-found\u002F",false,{"breadcrumb":97,"canonical":108,"description":109,"h1":110,"lastmod":111,"title":112},[98,101,104,106],{"name":99,"url":100},"Home","\u002F",{"name":102,"url":103},"Docs","\u002Fdocs\u002F",{"name":105,"url":69},"Errors",{"name":5,"url":107},"\u002Fdocs\u002Ferrors\u002Fchannel-locked\u002F","https:\u002F\u002Fwapito.com\u002Fdocs\u002Ferrors\u002Fchannel-locked\u002F","403 channel_locked: This channel is locked. The channel has been placed on hold and every write is refused until the hold is lifted.","channel_locked — Channel is locked","2026-09-15","channel_locked (403): Channel is locked | Wapito","channel-locked","t8","Channel is locked",[117],{"label":118,"id":119,"lang":119,"code":120,"html":121},"JSON","json","{\n  \"error\": {\n    \"code\": \"channel_locked\",\n    \"message\": \"This channel is locked.\",\n    \"request_id\": \"req_01JRQ8F4X9N2K7YB3C5V6W8H0T\"\n  }\n}","\u003Cpre class=\"shiki shiki-themes github-light-default github-dark-default\" style=\"background-color:#ffffff;--shiki-dark-bg:#0d1117;color:#1f2328;--shiki-dark:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">{\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#116329;--shiki-dark:#7EE787\">  \"error\"\u003C\u002Fspan>\u003Cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">: {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#116329;--shiki-dark:#7EE787\">    \"code\"\u003C\u002Fspan>\u003Cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#0A3069;--shiki-dark:#A5D6FF\">\"channel_locked\"\u003C\u002Fspan>\u003Cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#116329;--shiki-dark:#7EE787\">    \"message\"\u003C\u002Fspan>\u003Cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#0A3069;--shiki-dark:#A5D6FF\">\"This channel is locked.\"\u003C\u002Fspan>\u003Cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#116329;--shiki-dark:#7EE787\">    \"request_id\"\u003C\u002Fspan>\u003Cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#0A3069;--shiki-dark:#A5D6FF\">\"req_01JRQ8F4X9N2K7YB3C5V6W8H0T\"\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">  }\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">}\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>",1790464915622]