[{"data":1,"prerenderedAt":120},["ShallowReactive",2],{"pseo:errors:payload-too-large":3,"highlight:error:payload-too-large":114},{"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":56,"retryable":93,"seo":94,"slug":111,"tier":112,"title":113,"updated":109,"url":105},"The body you sent exceeds the size this plan allows. It usually means a media upload above the plan ceiling, but it also catches an oversized JSON body such as a bulk number check with far too many entries, or a base64 blob pasted inline instead of uploaded. WhatsApp has its own per-type media ceilings underneath, so a file can be refused here even when your plan would technically allow it.","payload_too_large",{"error":7},{"code":5,"message":8,"request_id":9},"The request payload is too large.","req_01JRQ8F4X9N2K7YB3C5V6W8H0T",[11,14],{"a":12,"q":13},"Both, and the smaller one wins. Your plan sets an upload ceiling and WhatsApp enforces its own maximum for each media type. A file that passes the plan check can still be refused by the engine, so treat the published plan number as an upper bound rather than a guarantee.","Is the limit set by Wapito or by WhatsApp?",{"a":15,"q":16},"The upload is refused before it reaches the engine, so no message is sent and no send quota is consumed. It still costs you a request against the monthly request allowance, which is another reason to check file sizes client-side before uploading.","Does a rejected upload count against my quota?",{"name":18,"slug":19,"url":20},"Post Status","post-status","\u002Fwhatsapp-api\u002Fpost-status\u002F",[22,23,24],"Upload media through the media endpoint and send the returned id rather than inlining bytes in the JSON body.","Compress or transcode before sending: a video re-encoded for mobile is usually a fraction of the original and arrives faster.","Split bulk requests into smaller batches and page through them instead of sending one enormous array.",413,[],[28,37,44,49],{"availability":29,"ban_risk":30,"method":31,"operationId":32,"path":33,"summary":34,"tag":35,"url":36},"ga","low","POST","uploadMedia","\u002Fmedia","Upload a file","media","\u002Fdocs\u002Fapi\u002Fmedia\u002Fupload-media\u002F",{"availability":29,"ban_risk":38,"method":31,"operationId":39,"path":40,"summary":41,"tag":42,"url":43},"medium","sendVideo","\u002Fmessages\u002Fvideo","Send a video","messages","\u002Fdocs\u002Fapi\u002Fmessages\u002Fsend-video\u002F",{"availability":29,"ban_risk":38,"method":31,"operationId":45,"path":46,"summary":47,"tag":42,"url":48},"sendDocument","\u002Fmessages\u002Fdocument","Send a document","\u002Fdocs\u002Fapi\u002Fmessages\u002Fsend-document\u002F",{"availability":29,"ban_risk":50,"method":31,"operationId":51,"path":52,"summary":53,"tag":54,"url":55},"high","checkContacts","\u002Fcontacts\u002Fcheck","Check numbers for WhatsApp registration","contacts","\u002Fdocs\u002Fapi\u002Fcontacts\u002Fcheck-contacts\u002F",{"glossary":57,"hub":67,"operations":68,"pillar":20,"siblings":77},[58,61,64],{"title":59,"url":60},"Status story","\u002Fglossary\u002Fstatus-story\u002F",{"title":62,"url":63},"PTT","\u002Fglossary\u002Fptt\u002F",{"title":65,"url":66},"Newsletter","\u002Fglossary\u002Fnewsletter\u002F","\u002Fdocs\u002Ferrors\u002F",[69,71,73,75],{"title":70,"url":36},"POST \u002Fmedia",{"title":72,"url":43},"POST \u002Fmessages\u002Fvideo",{"title":74,"url":48},"POST \u002Fmessages\u002Fdocument",{"title":76,"url":55},"POST \u002Fcontacts\u002Fcheck",[78,81,84,87,90],{"title":79,"url":80},"unsupported_media_type (415)","\u002Fdocs\u002Ferrors\u002Funsupported-media-type\u002F",{"title":82,"url":83},"channel_not_connected (409)","\u002Fdocs\u002Ferrors\u002Fchannel-not-connected\u002F",{"title":85,"url":86},"channel_not_in_qr_state (409)","\u002Fdocs\u002Ferrors\u002Fchannel-not-in-qr-state\u002F",{"title":88,"url":89},"business_account_required (409)","\u002Fdocs\u002Ferrors\u002Fbusiness-account-required\u002F",{"title":91,"url":92},"not_found (404)","\u002Fdocs\u002Ferrors\u002Fnot-found\u002F",false,{"breadcrumb":95,"canonical":106,"description":107,"h1":108,"lastmod":109,"title":110},[96,99,102,104],{"name":97,"url":98},"Home","\u002F",{"name":100,"url":101},"Docs","\u002Fdocs\u002F",{"name":103,"url":67},"Errors",{"name":5,"url":105},"\u002Fdocs\u002Ferrors\u002Fpayload-too-large\u002F","https:\u002F\u002Fwapito.com\u002Fdocs\u002Ferrors\u002Fpayload-too-large\u002F","413 payload_too_large: The request payload is too large. The body you sent exceeds the size this plan allows. 3 fix steps for the Wapito WhatsApp API.","payload_too_large — Payload is too large","2026-09-15","payload_too_large (413): Payload is too large | Wapito","payload-too-large","t8","Payload is too large",[115],{"label":116,"id":117,"lang":117,"code":118,"html":119},"JSON","json","{\n  \"error\": {\n    \"code\": \"payload_too_large\",\n    \"message\": \"The request payload is too large.\",\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\">\"payload_too_large\"\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 request payload is too large.\"\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>",1790464915739]