[{"data":1,"prerenderedAt":123},["ShallowReactive",2],{"pseo:errors:cold-send-limit":3,"highlight:error:cold-send-limit":117},{"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":57,"retryable":96,"seo":97,"slug":114,"tier":115,"title":116,"updated":112,"url":108},"A cold send is a message to a number that has never written to you and that you first wrote to less than a day ago. Wapito budgets those per hour because a fresh number blasting strangers is the pattern WhatsApp's abuse systems are tuned to catch: ten an hour on the first two days, twenty until the end of the first week, then sixty on premium and twenty on sandbox. The refused message was never sent and is not counted. details.cap and details.used show where the hour stands.","cold_send_limit",{"error":7},{"code":5,"message":8,"request_id":9},"The hourly limit for messages to new recipients is reached.","req_01JRQ8F4X9N2K7YB3C5V6W8H0T",[11,14],{"a":12,"q":13},"No. A recipient who has messaged you, or whom you first messaged more than twenty-four hours ago, is a known contact and is outside this budget entirely. Only first messages to strangers are metered, which is why a support inbox rarely sees this error while a cold outreach job hits it in minutes.","Does a reply to an existing conversation count against the cold-send cap?",{"a":15,"q":16},"Because that is when a number is most fragile. A freshly linked number with no history that immediately starts opening conversations with strangers looks exactly like a burner, and WhatsApp locks or bans those quickly. The ladder gives the number a week of ordinary-looking traffic before the ceiling rises, and the plan cap applies after that.","Why is the cap lower on the first two days after connecting?",{"name":18,"slug":19,"url":20},"Send Without Template","send-message-without-template","\u002Fwhatsapp-api\u002Fsend-message-without-template\u002F",[22,23,24],"Read details.cap and details.used, then hold the remaining cold messages until the top of the next hour rather than retrying in a loop.","Order your queue so replies to people who already wrote to you go first; they are never cold and never consume this budget.","Warm the number up over its first week with real conversations before pointing an outreach list at it, and keep the list to people who opted in.",429,[],[28,37,42,47,52],{"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":30,"method":31,"operationId":38,"path":39,"summary":40,"tag":35,"url":41},"sendImage","\u002Fmessages\u002Fimage","Send an image","\u002Fdocs\u002Fapi\u002Fmessages\u002Fsend-image\u002F",{"availability":29,"ban_risk":30,"method":31,"operationId":43,"path":44,"summary":45,"tag":35,"url":46},"sendDocument","\u002Fmessages\u002Fdocument","Send a document","\u002Fdocs\u002Fapi\u002Fmessages\u002Fsend-document\u002F",{"availability":29,"ban_risk":30,"method":31,"operationId":48,"path":49,"summary":50,"tag":35,"url":51},"sendLocation","\u002Fmessages\u002Flocation","Send a location pin","\u002Fdocs\u002Fapi\u002Fmessages\u002Fsend-location\u002F",{"availability":29,"ban_risk":30,"method":31,"operationId":53,"path":54,"summary":55,"tag":35,"url":56},"sendPoll","\u002Fmessages\u002Fpoll","Send a poll","\u002Fdocs\u002Fapi\u002Fmessages\u002Fsend-poll\u002F",{"glossary":58,"hub":68,"operations":69,"pillar":20,"siblings":80},[59,62,65],{"title":60,"url":61},"Cloud API","\u002Fglossary\u002Fcloud-api\u002F",{"title":63,"url":64},"Cold send","\u002Fglossary\u002Fcold-send\u002F",{"title":66,"url":67},"ACK","\u002Fglossary\u002Fack\u002F","\u002Fdocs\u002Ferrors\u002F",[70,72,74,76,78],{"title":71,"url":36},"POST \u002Fmessages\u002Ftext",{"title":73,"url":41},"POST \u002Fmessages\u002Fimage",{"title":75,"url":46},"POST \u002Fmessages\u002Fdocument",{"title":77,"url":51},"POST \u002Fmessages\u002Flocation",{"title":79,"url":56},"POST \u002Fmessages\u002Fpoll",[81,84,87,90,93],{"title":82,"url":83},"rate_limited (429)","\u002Fdocs\u002Ferrors\u002Frate-limited\u002F",{"title":85,"url":86},"quota_exceeded (429)","\u002Fdocs\u002Ferrors\u002Fquota-exceeded\u002F",{"title":88,"url":89},"send_rate_limited (429)","\u002Fdocs\u002Ferrors\u002Fsend-rate-limited\u002F",{"title":91,"url":92},"warmup_limit (429)","\u002Fdocs\u002Ferrors\u002Fwarmup-limit\u002F",{"title":94,"url":95},"reachout_timelocked (423)","\u002Fdocs\u002Ferrors\u002Freachout-timelocked\u002F",true,{"breadcrumb":98,"canonical":109,"description":110,"h1":111,"lastmod":112,"title":113},[99,102,105,107],{"name":100,"url":101},"Home","\u002F",{"name":103,"url":104},"Docs","\u002Fdocs\u002F",{"name":106,"url":68},"Errors",{"name":5,"url":108},"\u002Fdocs\u002Ferrors\u002Fcold-send-limit\u002F","https:\u002F\u002Fwapito.com\u002Fdocs\u002Ferrors\u002Fcold-send-limit\u002F","429 cold_send_limit: The hourly limit for messages to new recipients is reached. The refused message was never sent and is not counted.","cold_send_limit — Cold-send cap reached","2026-09-17","cold_send_limit (429): Cold-send cap reached | Wapito","cold-send-limit","t8","Cold-send cap reached",[118],{"label":119,"id":120,"lang":120,"code":121,"html":122},"JSON","json","{\n  \"error\": {\n    \"code\": \"cold_send_limit\",\n    \"message\": \"The hourly limit for messages to new recipients is reached.\",\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\">\"cold_send_limit\"\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\">\"The hourly limit for messages to new recipients is reached.\"\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>",1790464915921]