{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Watahub","colors":{"primary":"#0F766E","light":"#14B8A6","dark":"#0D9488"},"api":{"playground":{"display":"simple"},"examples":{"languages":["bash","javascript","python"],"prefill":false}},"styling":{"latex":false},"navigation":{"languages":[{"language":"en","href":"en/overview"},{"language":"es","href":"es/overview"},{"language":"pt-BR","href":"pt-BR/overview"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"watahub","hasAudioNarration":false,"actualSubdomain":"watahub","customDomains":["docs.watahub.dev"],"gitSource":{"type":"github","owner":"hub-ventures","repo":"watahub-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":"","_id":"6af0c45dd4da7f8c5c6c255e"},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6af0e10dd4da7f8c5c6d8504","clientVersion":"0.0.4088","searchFilterCounts":[{"language":"en","tag":"API reference","count":39},{"language":"es","tag":"Referencia API","count":39},{"language":"pt-BR","tag":"Referência da API","count":39},{"language":"en","tag":"Guides","count":7},{"language":"en","tag":"Webhook events","count":7},{"language":"es","tag":"Guías","count":7},{"language":"es","tag":"Eventos de webhook","count":7},{"language":"pt-BR","tag":"Guias","count":7},{"language":"pt-BR","tag":"Eventos de webhook","count":7},{"language":"en","tag":"Getting started","count":4},{"language":"es","tag":"Primeros pasos","count":4},{"language":"pt-BR","tag":"Primeiros passos","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"en/api/sendMessage","slug":"/en/api/sendMessage","pageMetadata":{"title":"Send a WhatsApp message","description":"Send a WhatsApp message","keywords":["Watahub","api/sendMessage"],"openapi":"openapi.json POST /v1/messages","href":"/en/api/sendMessage"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Send a WhatsApp message\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Send a WhatsApp message","description":"Send a WhatsApp message","keywords":["Watahub","api/sendMessage"],"openapi":"openapi.json POST /v1/messages","href":"/en/api/sendMessage"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Messages"],"summary":"Send a WhatsApp message","description":"Send a WhatsApp message","responses":{"200":"712fbf89-9d42-4cdb-89e6-9878c3775d2a","4XX":"e7b74bb2-5bd4-4fb9-b88a-4e22886409d9","5XX":"0b5fb924-d6df-4719-bd06-db83c29f4a94"},"requestBody":"eca09981-8530-438c-8b2c-0bcec55fe751","operationId":"sendMessage","method":"post","type":"path","servers":["614b8d5c-f358-4acf-8538-6ebc1d36abce"],"security":["0f1937b0-096e-4555-9a01-71ac3b27104a","3c1d24fa-c2a6-4490-8c76-06163121bfa1"],"path":"/v1/messages","baseUrlOptions":["https://cloud.watahub.dev"],"title":"Send a WhatsApp message","codeSamples":[],"requestExampleLanguages":["bash","javascript","python"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["to","kind"],"description":"The object matching `kind` is required (`media` for image, audio, video, document and sticker).","properties":{"to":{"type":"string","minLength":1,"maxLength":135,"description":"Recipient phone number or business-scoped user ID.","isRequired":true,"uniqueKey":"to","typeLabel":"string"},"kind":{"type":"string","enum":["text","template","image","audio","video","document","reaction","interactive","location","contacts","sticker"],"isRequired":true,"uniqueKey":"kind","typeLabel":"enum\u003cstring>"},"phoneNumberId":{"type":"string","pattern":"^\\d{1,32}$","uniqueKey":"phoneNumberId","typeLabel":"string"},"text":{"type":"object","required":["body"],"properties":{"body":{"type":"string","minLength":1,"maxLength":4096,"isRequired":true,"uniqueKey":"text.body","typeLabel":"string"}},"uniqueKey":"text","typeLabel":"object"},"template":{"type":"object","required":["name","language"],"properties":{"name":{"type":"string","maxLength":512,"isRequired":true,"uniqueKey":"template.name","typeLabel":"string"},"language":{"type":"object","required":["code"],"properties":{"code":{"type":"string","minLength":2,"maxLength":16,"isRequired":true,"uniqueKey":"template.language.code","typeLabel":"string"}},"isRequired":true,"uniqueKey":"template.language","typeLabel":"object"},"components":{"type":"array","items":{"type":"object","additionalProperties":true,"uniqueKey":"template.components.items.[INDEX]","typeLabel":"object"},"uniqueKey":"template.components","typeLabel":"object[]"}},"uniqueKey":"template","typeLabel":"object"},"media":{"type":"object","description":"Provide id or link. Audio: no caption/filename; voice only for audio. Video: no filename.","properties":{"id":{"type":"string","pattern":"^\\d{1,32}$","uniqueKey":"media.id","typeLabel":"string"},"link":{"type":"string","format":"uri","uniqueKey":"media.link","typeLabel":"string\u003curi>"},"caption":{"type":"string","maxLength":1024,"uniqueKey":"media.caption","typeLabel":"string"},"filename":{"type":"string","maxLength":240,"uniqueKey":"media.filename","typeLabel":"string"},"voice":{"type":"boolean","uniqueKey":"media.voice","typeLabel":"boolean"}},"uniqueKey":"media","typeLabel":"object"},"reaction":{"type":"object","required":["messageId","emoji"],"properties":{"messageId":{"type":"string","maxLength":256,"isRequired":true,"uniqueKey":"reaction.messageId","typeLabel":"string"},"emoji":{"type":"string","maxLength":16,"isRequired":true,"uniqueKey":"reaction.emoji","typeLabel":"string"}},"uniqueKey":"reaction","typeLabel":"object"},"location":{"type":"object","required":["latitude","longitude"],"properties":{"latitude":{"type":"number","minimum":-90,"maximum":90,"isRequired":true,"uniqueKey":"location.latitude","typeLabel":"number"},"longitude":{"type":"number","minimum":-180,"maximum":180,"isRequired":true,"uniqueKey":"location.longitude","typeLabel":"number"},"name":{"type":"string","maxLength":256,"uniqueKey":"location.name","typeLabel":"string"},"address":{"type":"string","maxLength":512,"uniqueKey":"location.address","typeLabel":"string"}},"uniqueKey":"location","typeLabel":"object"},"contacts":{"type":"array","minItems":1,"maxItems":10,"items":{"type":"object","additionalProperties":true,"description":"WhatsApp contact card; name.formatted_name required.","uniqueKey":"contacts.items.[INDEX]","typeLabel":"object"},"uniqueKey":"contacts","typeLabel":"object[]"},"interactive":{"type":"object","additionalProperties":true,"description":"Meta interactive object. Validated for type flow, location_request_message, cta_url, product, product_list and order_details.","uniqueKey":"interactive","typeLabel":"object"},"replyToMessageId":{"type":"string","maxLength":256,"uniqueKey":"replyToMessageId","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"to":"\u003cstring>","phoneNumberId":"\u003cstring>","media":{"id":"\u003cstring>","link":"\u003cstring>","caption":"\u003cstring>","filename":"\u003cstring>","voice":true},"contacts":[{}],"interactive":{},"replyToMessageId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"712fbf89-9d42-4cdb-89e6-9878c3775d2a":{"description":"Meta accepted the message.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["success","messageId","recipient","phoneNumberId"],"properties":{"success":{"const":true,"isRequired":true,"uniqueKey":"success","typeLabel":"any"},"messageId":{"type":"string","description":"Meta's `messages[0].id` (the wamid). Empty when Meta returns none.","isRequired":true,"uniqueKey":"messageId","typeLabel":"string"},"recipient":{"type":"string","description":"Meta's `contacts[0].input`; otherwise the phone number sent, without `+`, or the BSUID.","isRequired":true,"uniqueKey":"recipient","typeLabel":"string"},"phoneNumberId":{"type":"string","description":"The number that sent the message.","isRequired":true,"uniqueKey":"phoneNumberId","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"messageId":"\u003cstring>","recipient":"\u003cstring>","phoneNumberId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"e7b74bb2-5bd4-4fb9-b88a-4e22886409d9":{"description":"Rejected by the gateway (`GatewayError`), by the core's validation (`ValidationError`, 422) or by Meta (`MetaError`, with Meta's status).","content":{"application/json":{"schema":{"oneOf":[{"type":"object","description":"An error the gateway or the core answers itself. `error` is a stable English message for developers.","required":["error"],"properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.error","typeLabel":"string"},"fields":{"type":"array","items":{"type":"string","uniqueKey":"oneOf.0.fields.items.[INDEX]","typeLabel":"string"},"description":"With 400 `Invalid fields`: the paths of the rejected fields.","uniqueKey":"oneOf.0.fields","typeLabel":"string[]"},"requestId":{"type":"string","description":"With 500 `Operation unavailable`: the ID to quote to support.","uniqueKey":"oneOf.0.requestId","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","description":"The core rejected a value of the body, path, header or query.","required":["error","details"],"properties":{"error":{"const":"Validation failed","isRequired":true,"uniqueKey":"oneOf.1.error","typeLabel":"any"},"details":{"type":"object","description":"Messages by field name.","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"oneOf.1.details.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"oneOf.1.details.additionalProperties","typeLabel":"string[]"},"isRequired":true,"uniqueKey":"oneOf.1.details","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"oneOf.1","typeLabel":"object"},{"type":"object","description":"Meta failed a `/v1` call. With Meta's error: `code`, its `subcode`, `type` on sends, and the core's classification. When Meta could not be reached or answered something unusable, only `message`, plus the `unknown_outcome` classification on sends.","required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"oneOf.2.error.message","typeLabel":"string"},"code":{"type":"integer","description":"Meta's error code; Meta's HTTP status when Meta gave none.","uniqueKey":"oneOf.2.error.code","typeLabel":"integer"},"subcode":{"type":"integer","description":"Meta's `error_subcode`.","uniqueKey":"oneOf.2.error.subcode","typeLabel":"integer"},"type":{"type":"string","description":"Meta's error type. Only on message sends.","uniqueKey":"oneOf.2.error.type","typeLabel":"string"},"category":{"type":"string","enum":["auth","billing","rate_limit","meta_server","unknown","unknown_outcome"],"uniqueKey":"oneOf.2.error.category","typeLabel":"enum\u003cstring>"},"retryable":{"type":"boolean","uniqueKey":"oneOf.2.error.retryable","typeLabel":"boolean"},"action":{"type":"string","description":"What to do next, in English.","uniqueKey":"oneOf.2.error.action","typeLabel":"string"}},"isRequired":true,"uniqueKey":"oneOf.2.error","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"oneOf.2","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","fields":["\u003cstring>"],"requestId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"0b5fb924-d6df-4719-bd06-db83c29f4a94":{"description":"`GatewayError` for a gateway failure (500 with `requestId`, 503 for missing configuration); `MetaError` for a Meta 5XX, an unreachable Meta (502) or a Meta timeout (504).","content":{"application/json":{"schema":{"oneOf":[{"type":"object","description":"An error the gateway or the core answers itself. `error` is a stable English message for developers.","required":["error"],"properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.error","typeLabel":"string"},"fields":{"type":"array","items":{"type":"string","uniqueKey":"oneOf.0.fields.items.[INDEX]","typeLabel":"string"},"description":"With 400 `Invalid fields`: the paths of the rejected fields.","uniqueKey":"oneOf.0.fields","typeLabel":"string[]"},"requestId":{"type":"string","description":"With 500 `Operation unavailable`: the ID to quote to support.","uniqueKey":"oneOf.0.requestId","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","description":"Meta failed a `/v1` call. With Meta's error: `code`, its `subcode`, `type` on sends, and the core's classification. When Meta could not be reached or answered something unusable, only `message`, plus the `unknown_outcome` classification on sends.","required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.error.message","typeLabel":"string"},"code":{"type":"integer","description":"Meta's error code; Meta's HTTP status when Meta gave none.","uniqueKey":"oneOf.1.error.code","typeLabel":"integer"},"subcode":{"type":"integer","description":"Meta's `error_subcode`.","uniqueKey":"oneOf.1.error.subcode","typeLabel":"integer"},"type":{"type":"string","description":"Meta's error type. Only on message sends.","uniqueKey":"oneOf.1.error.type","typeLabel":"string"},"category":{"type":"string","enum":["auth","billing","rate_limit","meta_server","unknown","unknown_outcome"],"uniqueKey":"oneOf.1.error.category","typeLabel":"enum\u003cstring>"},"retryable":{"type":"boolean","uniqueKey":"oneOf.1.error.retryable","typeLabel":"boolean"},"action":{"type":"string","description":"What to do next, in English.","uniqueKey":"oneOf.1.error.action","typeLabel":"string"}},"isRequired":true,"uniqueKey":"oneOf.1.error","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","fields":["\u003cstring>"],"requestId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"0f1937b0-096e-4555-9a01-71ac3b27104a":{"bearerApiKey":{"type":"http","scheme":"bearer","description":"Tenant API key.","scopes":[],"schemeName":"bearerApiKey"}},"3c1d24fa-c2a6-4490-8c76-06163121bfa1":{"headerApiKey":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Tenant API key.","scopes":[],"schemeName":"headerApiKey"}}},"servers":{"614b8d5c-f358-4acf-8538-6ebc1d36abce":{"url":"https://cloud.watahub.dev"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Tenant API key.","scopes":[],"schemeName":"bearerApiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Tenant API key.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerApiKey","name":"Authorization"}],"title":"bearerApiKey"},{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Tenant API key.","scopes":[],"schemeName":"headerApiKey"},"schema":{"title":"X-API-Key","type":"string","description":"Tenant API key.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"headerApiKey","name":"X-API-Key"}],"title":"headerApiKey"}]},"originalFileLocation":"openapi.json"},"subdomain":"watahub","siteName":"Watahub","title":"Send a WhatsApp message - Watahub","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/en/api/sendMessage","matchLevel":0},"es":{"href":"/es/api/sendMessage","matchLevel":1},"pt-BR":{"href":"/pt-BR/api/sendMessage","matchLevel":1}}},"lastModified":"2026-11-08T20:52:37.717Z","originalFileLocation":"en/api/sendMessage.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Send a WhatsApp message\">\u003cmeta data-mint-head name=\"application-name\" content=\"Watahub\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/watahub/_generated/favicon/apple-touch-icon.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/watahub/_generated/favicon/favicon-32x32.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/watahub/_generated/favicon/favicon-16x16.png?v=3\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/watahub/_generated/favicon/favicon.ico?v=3\">\u003cmeta data-mint-head property=\"og:title\" content=\"Send a WhatsApp message - Watahub\">\u003cmeta data-mint-head property=\"og:description\" content=\"Send a WhatsApp message\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Watahub\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.watahub.dev/en/api/sendMessage\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://watahub.mintlify.site/_mintlify/api/og/v2?division=API+reference\u0026amp;title=Send+a+WhatsApp+message\u0026amp;description=Send+a+WhatsApp+message\u0026amp;theme=8157bd32ddef625e2bd30aba\u0026amp;signature=fd7453cfdffec8d3742a881190cec1af7e2bb08925d330efd77ee7958203612e\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Send a WhatsApp message - Watahub\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Send a WhatsApp message\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://watahub.mintlify.site/_mintlify/api/og/v2?division=API+reference\u0026amp;title=Send+a+WhatsApp+message\u0026amp;description=Send+a+WhatsApp+message\u0026amp;theme=8157bd32ddef625e2bd30aba\u0026amp;signature=fd7453cfdffec8d3742a881190cec1af7e2bb08925d330efd77ee7958203612e\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"https://mintlify.s3.us-west-1.amazonaws.com/watahub/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Watahub\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0F766E\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.watahub.dev/en/api/sendMessage\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/en/api/sendMessage.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.watahub.dev/en/api/sendMessage\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.watahub.dev/es/api/sendMessage\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt-BR\" href=\"https://docs.watahub.dev/pt-BR/api/sendMessage\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.watahub.dev/en/api/sendMessage\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.watahub.dev/#organization\",\"name\":\"Watahub\",\"url\":\"https://docs.watahub.dev\"},{\"@type\":\"WebSite\",\"@id\":\"https://docs.watahub.dev#website\",\"name\":\"Watahub\",\"url\":\"https://docs.watahub.dev\",\"publisher\":{\"@id\":\"https://docs.watahub.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.watahub.dev/en/api/sendMessage#webpage\",\"url\":\"https://docs.watahub.dev/en/api/sendMessage\",\"name\":\"Send a WhatsApp message\",\"description\":\"Send a WhatsApp message\",\"dateModified\":\"2026-11-08T20:52:37.717Z\",\"isPartOf\":{\"@id\":\"https://docs.watahub.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.watahub.dev/en/api/sendMessage#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.watahub.dev/en/api/sendMessage#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Watahub\",\"item\":\"https://docs.watahub.dev\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Send a WhatsApp message\",\"item\":\"https://docs.watahub.dev/en/api/sendMessage\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.watahub.dev/en/api/sendMessage#apireference\",\"headline\":\"Send a WhatsApp message\",\"name\":\"Send a WhatsApp message\",\"description\":\"Send a WhatsApp message\",\"url\":\"https://docs.watahub.dev/en/api/sendMessage\",\"mainEntityOfPage\":{\"@id\":\"https://docs.watahub.dev/en/api/sendMessage#webpage\"},\"dateModified\":\"2026-11-08T20:52:37.717Z\",\"keywords\":\"Watahub, api/sendMessage\",\"publisher\":{\"@id\":\"https://docs.watahub.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.watahub.dev#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Watahub\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Watahub","nav":{"global":null,"languages":[{"language":"en","groups":[{"group":"Getting started","pages":[{"title":"Introduction","href":"/en/overview"},{"title":"Quickstart","href":"/en/quickstart"},{"title":"Authentication","href":"/en/authentication"},{"title":"Connect customer numbers","href":"/en/connect"}]},{"group":"Guides","pages":[{"title":"Messages and media","href":"/en/messages-media"},{"title":"Conversations","href":"/en/conversations"},{"title":"Webhooks","href":"/en/webhooks"},{"title":"Templates","href":"/en/templates"},{"title":"Broadcasts","href":"/en/broadcasts"},{"title":"Errors and retries","href":"/en/errors"},{"title":"API behavior","description":"Understand response formats and the limited Graph-compatible interface.","href":"/en/api-behavior"}]},{"group":"API reference","pages":[{"title":"Send a WhatsApp message","openapi":"openapi.json POST /v1/messages","href":"/en/api/sendMessage"},{"title":"List recent messages","description":"List recent messages","openapi":"openapi.json GET /v1/messages","href":"/en/api/listMessages"},{"title":"Send a text message in an Inbox conversation","openapi":"openapi.json POST /v1/conversations/{conversationId}/messages","href":"/en/api/sendConversationText"},{"title":"List conversation messages","openapi":"openapi.json GET /v1/conversations/{conversationId}/messages","href":"/en/api/listConversationMessages"},{"title":"Upload media","openapi":"openapi.json POST /v1/media","href":"/en/api/uploadMedia"},{"title":"Resolve a media ID to Meta's download URL","openapi":"openapi.json GET /v1/media/{id}","href":"/en/api/getMedia"},{"title":"Upload media for a named number","openapi":"openapi.json POST /v1/media/{id}","href":"/en/api/uploadPhoneMedia"},{"title":"Download media bytes","openapi":"openapi.json GET /v1/media/{mediaId}/content","href":"/en/api/getMediaContent"},{"title":"List a WABA's message templates","openapi":"openapi.json GET /v1/templates","href":"/en/api/getTemplates"},{"title":"List a WABA's message templates","openapi":"openapi.json GET /v1/templates/{wabaId}","href":"/en/api/listTemplates"},{"title":"Send a message with Meta's request and response","openapi":"openapi.json POST /v{graphVersion}/{phoneNumberId}/messages","href":"/en/api/postVgraphVersionPhoneNumberIdMessages"},{"title":"Upload media with Meta's request and response","openapi":"openapi.json POST /v{graphVersion}/{phoneNumberId}/media","href":"/en/api/postVgraphVersionPhoneNumberIdMedia"},{"title":"Read a media object with Meta's response","openapi":"openapi.json GET /v{graphVersion}/{mediaId}","href":"/en/api/getVgraphVersionMediaId"},{"title":"List phone numbers","openapi":"openapi.json GET /v1/phones","href":"/en/api/listPhones"},{"title":"List conversations","openapi":"openapi.json GET /v1/conversations","href":"/en/api/listConversations"},{"title":"Get a conversation","openapi":"openapi.json GET /v1/conversations/{conversationId}","href":"/en/api/getConversation"},{"title":"Assign a conversation","openapi":"openapi.json PATCH /v1/conversations/{conversationId}","href":"/en/api/assignConversation"},{"title":"Create a setup link","openapi":"openapi.json POST /v1/setup-links","href":"/en/api/createSetupLink"},{"title":"Connect a preassigned line","openapi":"openapi.json POST /v1/onboarding/connect","href":"/en/api/onboardingConnect"},{"title":"List customers","openapi":"openapi.json GET /v1/customers","href":"/en/api/listCustomers"},{"title":"Create a customer","openapi":"openapi.json POST /v1/customers","href":"/en/api/createCustomer"},{"title":"Create a setup link for a customer","openapi":"openapi.json POST /v1/customers/{customerId}/setup-links","href":"/en/api/createCustomerSetupLink"},{"title":"List project webhooks","openapi":"openapi.json GET /v1/project-webhooks","href":"/en/api/listProjectWebhooks"},{"title":"Create a project webhook","openapi":"openapi.json POST /v1/project-webhooks","href":"/en/api/createProjectWebhook"},{"title":"Update a project webhook","openapi":"openapi.json PATCH /v1/project-webhooks/{webhookId}","href":"/en/api/updateProjectWebhook"},{"title":"Delete a project webhook","openapi":"openapi.json DELETE /v1/project-webhooks/{webhookId}","href":"/en/api/deleteProjectWebhook"},{"title":"List phone webhooks","openapi":"openapi.json GET /v1/phones/{phoneNumberId}/webhooks","href":"/en/api/listPhoneWebhooks"},{"title":"Create a phone webhook","openapi":"openapi.json POST /v1/phones/{phoneNumberId}/webhooks","href":"/en/api/createPhoneWebhook"},{"title":"Update a phone webhook","openapi":"openapi.json PATCH /v1/phones/{phoneNumberId}/webhooks/{webhookId}","href":"/en/api/updatePhoneWebhook"},{"title":"Delete a phone webhook","openapi":"openapi.json DELETE /v1/phones/{phoneNumberId}/webhooks/{webhookId}","href":"/en/api/deletePhoneWebhook"},{"title":"List activity logs","openapi":"openapi.json GET /v1/logs","href":"/en/api/listLogs"},{"title":"Health","openapi":"openapi.json GET /health","href":"/en/api/health"},{"title":"List cached templates","openapi":"openapi.json GET /v1/message-templates","href":"/en/api/listCachedTemplates"},{"title":"Create a template","openapi":"openapi.json POST /v1/message-templates","href":"/en/api/createCachedTemplate"},{"title":"Sync templates from Meta","openapi":"openapi.json POST /v1/message-templates/sync","href":"/en/api/syncCachedTemplates"},{"title":"List broadcasts","openapi":"openapi.json GET /v1/broadcasts","href":"/en/api/listBroadcasts"},{"title":"Create a broadcast","openapi":"openapi.json POST /v1/broadcasts","href":"/en/api/createBroadcast"},{"title":"Get a broadcast","openapi":"openapi.json GET /v1/broadcasts/{broadcastId}","href":"/en/api/getBroadcast"},{"title":"Send a broadcast","openapi":"openapi.json POST /v1/broadcasts/{broadcastId}/send","href":"/en/api/sendBroadcast"}]},{"group":"Webhook events","pages":[{"title":"whatsapp.message.received","openapi":"openapi.json webhook whatsapp.message.received","href":"/en/events/whatsapp-message-received"},{"title":"whatsapp.message.sent","openapi":"openapi.json webhook whatsapp.message.sent","href":"/en/events/whatsapp-message-sent"},{"title":"whatsapp.message.delivered","openapi":"openapi.json webhook whatsapp.message.delivered","href":"/en/events/whatsapp-message-delivered"},{"title":"whatsapp.message.read","openapi":"openapi.json webhook whatsapp.message.read","href":"/en/events/whatsapp-message-read"},{"title":"whatsapp.message.failed","openapi":"openapi.json webhook whatsapp.message.failed","href":"/en/events/whatsapp-message-failed"},{"title":"whatsapp.phone_number.created","openapi":"openapi.json webhook whatsapp.phone_number.created","href":"/en/events/whatsapp-phone_number-created"},{"title":"whatsapp.phone_number.disconnected","openapi":"openapi.json webhook whatsapp.phone_number.disconnected","href":"/en/events/whatsapp-phone_number-disconnected"}]}]},{"language":"es","pages":[{"title":"es","href":"/es/api/sendMessage"}]},{"language":"pt-BR","pages":[{"title":"pt-BR","href":"/pt-BR/api/sendMessage"}]}]},"basePath":"","title":"Send a WhatsApp message - Watahub","buildId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","deploymentId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-5FCzAcfS.js","utils-SLtAG4EZ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-2DZi8ZMu.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D7J3nkzE.js","snippetPresets-D0Alv0AH.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BI4qNJ2c.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BD3uyr8j.js","shallow-D8iEBr5z.js","getApiPlaygroundDisplay-CgNP4lzR.js","CodeSnippet-CX-QHuMs.js","CodeSnippets-VlXE-ZUf.js","Page-D9ithiIZ.js","getPastedJson-DYNQkZ1M.js","icon-CzacdwOi.js","MethodPill-2JVqoYKi.js","DuplicateIcon-_xVXs-U8.js","createIcon-BRHrweLo.js","DynamicMarkdown-mQG_iQiE.js","SectionHeading-DMpJzv8f.js","axios-vUo_bRtp.js","Markdown-5FGIym-8.js","clsx-D-TRO5q5.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CdrJecqK.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CHlcWBLM.js"]}