{
"code": "ERROR_CODE_INPUT_ERROR",
"message": "Template 'seguimiento_presupuesto' not found or not APPROVED.",
"payload": {
"campaign_id": null,
"external_ref": null
}
}
{
"code": "ERROR_CODE_INPUT_ERROR",
"message": "Template 'seguimiento_presupuesto' not found or not APPROVED.",
"payload": {
"campaign_id": null,
"external_ref": null
}
}
{
"code": "ERROR_CODE_INPUT_ERROR",
"message": "Template 'seguimiento_presupuesto' not found or not APPROVED.",
"payload": {
"campaign_id": null,
"external_ref": null
}
}
API Reference
Enviar un template (campaña)
Una sola llamada crea la campaña, carga el/los destinatario(s) y ejecuta
el envío. Devuelve el campaign_id que después llega en el webhook de
respuestas.
Idempotencia: si reintentás con la misma idempotency_key, no se
duplica el envío — devolvemos la respuesta original con replayed: true.
Ante un error 502, reintentá con la misma clave.
{
"code": "ERROR_CODE_INPUT_ERROR",
"message": "Template 'seguimiento_presupuesto' not found or not APPROVED.",
"payload": {
"campaign_id": null,
"external_ref": null
}
}
{
"code": "ERROR_CODE_INPUT_ERROR",
"message": "Template 'seguimiento_presupuesto' not found or not APPROVED.",
"payload": {
"campaign_id": null,
"external_ref": null
}
}
{
"code": "ERROR_CODE_INPUT_ERROR",
"message": "Template 'seguimiento_presupuesto' not found or not APPROVED.",
"payload": {
"campaign_id": null,
"external_ref": null
}
}
URL pública https del archivo del header. Obligatorio si el template
tiene header de imagen, video o documento (PDF) — sin este campo el envío
devuelve 400. No se acepta base64: el archivo tiene que estar hosteado y ser
descargable sin autenticación. Límites de WhatsApp: imagen 5 MB (jpg/png),
video 16 MB (mp4), documento 100 MB (PDF). Para documentos, el nombre del
archivo se toma de la URL.
Response
Envío ejecutado (o replay idempotente de un envío previo).
true si esta respuesta es el replay de un envío previo con la misma idempotency_key.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Xenda Partner API","description":"API para integraciones externas con la plataforma Xenda: envío de templates de WhatsApp vía campañas y webhook de respuestas.","colors":{"primary":"#6D28D9","light":"#8B5CF6","dark":"#5B21B6"},"logo":{"light":"https://mintcdn.com/xenda/MZRxpO0ybtOKSc2r/logo/logo_light.png?fit=max\u0026auto=format\u0026n=MZRxpO0ybtOKSc2r\u0026q=85\u0026s=e0fc539a255c677092c01ceedeb704cb","dark":"https://mintcdn.com/xenda/MZRxpO0ybtOKSc2r/logo/logo_dark.png?fit=max\u0026auto=format\u0026n=MZRxpO0ybtOKSc2r\u0026q=85\u0026s=be28a74bd4bee9a2dfb34f44a8353321","href":"https://xenda.ai"},"favicon":"https://mintcdn.com/xenda/MZRxpO0ybtOKSc2r/favicon.png?fit=max\u0026auto=format\u0026n=MZRxpO0ybtOKSc2r\u0026q=85\u0026s=27cb4692e2a28b4bf23205536dae9a4c","footer":{"links":[{"header":"Xenda","items":[{"label":"Sitio web","href":"https://xenda.ai"},{"label":"Contacto","href":"mailto:contacto@xenda.ai"}]}]},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"xenda","hasAudioNarration":false,"actualSubdomain":"xenda","customDomains":["partner-api.xenda.ai"],"gitSource":{"type":"github","owner":"gonzarodriguez89","repo":"xenda-partner-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"collectionId":"06f03602-dccf-4ea1-9e3e-3bf8399cdf17","liveDeploymentHistoryId":"6acd202305a84ceec519dbc3","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6acd202305a84ceec519dbc3"},"entitlements":{},"buildId":"6acd202305a84ceec519dbc3","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"API Reference","count":18},{"language":"default","tag":"POS Bridge","count":9},{"language":"default","tag":"Campañas de WhatsApp","count":6},{"language":"default","tag":"Empezar","count":5},{"language":"default","tag":"Novedades","count":2},{"language":"default","tag":"Webhooks","count":1}]},"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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/enviar-un-template-campaña","slug":"/api-reference/enviar-un-template-campaña","pageMetadata":{"title":"Enviar un template (campaña)","description":"Una sola llamada crea la campaña, carga el/los destinatario(s) y ejecuta\nel envío. Devuelve el `campaign_id` que después llega en el webhook de\nrespuestas.\n\n**Idempotencia**: si reintentás con la misma `idempotency_key`, no se\nduplica el envío — devolvemos la respuesta original con `replayed: true`.\nAnte un error `502`, reintentá con la **misma** clave.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml post /campaigns","href":"/api-reference/enviar-un-template-campaña","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Una sola llamada crea la campaña, carga el/los destinatario(s) y ejecuta\\nel envío. Devuelve el \", _jsx(_components.code, {\n children: \"campaign_id\"\n }), \" que después llega en el webhook de\\nrespuestas.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Idempotencia\"\n }), \": si reintentás con la misma \", _jsx(_components.code, {\n children: \"idempotency_key\"\n }), \", no se\\nduplica el envío — devolvemos la respuesta original con \", _jsx(_components.code, {\n children: \"replayed: true\"\n }), \".\\nAnte un error \", _jsx(_components.code, {\n children: \"502\"\n }), \", reintentá con la \", _jsx(_components.strong, {\n children: \"misma\"\n }), \" clave.\"]\n })]\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":"Enviar un template (campaña)","description":"Una sola llamada crea la campaña, carga el/los destinatario(s) y ejecuta\nel envío. Devuelve el `campaign_id` que después llega en el webhook de\nrespuestas.\n\n**Idempotencia**: si reintentás con la misma `idempotency_key`, no se\nduplica el envío — devolvemos la respuesta original con `replayed: true`.\nAnte un error `502`, reintentá con la **misma** clave.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml post /campaigns","href":"/api-reference/enviar-un-template-campaña","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"sendCampaign","summary":"Enviar un template (campaña)","description":"Una sola llamada crea la campaña, carga el/los destinatario(s) y ejecuta\nel envío. Devuelve el `campaign_id` que después llega en el webhook de\nrespuestas.\n\n**Idempotencia**: si reintentás con la misma `idempotency_key`, no se\nduplica el envío — devolvemos la respuesta original con `replayed: true`.\nAnte un error `502`, reintentá con la **misma** clave.\n","requestBody":"301b1a25-2a0d-442a-97a3-46bb127fc86e","responses":{"200":"39a073ef-9f8d-4605-b0ff-1c5b1132fdb3","400":"f9808c24-eb86-4b29-9ba4-b5ba757bde1d","403":"202fed49-e597-4505-b585-5483b0edbba1","500":"dc715cee-a4d8-4d31-aa4e-13d60b7cf2ef"},"method":"post","type":"path","servers":["9591bc63-3924-412b-aecb-ca5069c20389"],"security":["4f11b2e6-233c-497c-9617-a61362e83b78"],"path":"/campaigns","baseUrlOptions":["https://api.automationhub.one/api:RIKjHOHm"],"title":"Enviar un template (campaña)","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["idempotency_key","recipients"],"properties":{"idempotency_key":{"type":"string","maxLength":128,"description":"Clave única por envío. Reintentos con la misma clave no duplican el envío.","isRequired":true,"uniqueKey":"idempotency_key","typeLabel":"string"},"recipients":{"type":"array","minItems":1,"maxItems":1000,"items":{"type":"object","required":["phone"],"properties":{"phone":{"type":"string","description":"Teléfono en formato internacional (ej. `+5491123456789`).","isRequired":true,"uniqueKey":"recipients.items.[INDEX].phone","typeLabel":"string"},"params":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"recipients.items.[INDEX].params.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Variables del template. Array para posicionales (`{{1}}`, `{{2}}`)\nu objeto para variables con nombre (`{\"nombre\": \"Juan\"}`).\n","uniqueKey":"recipients.items.[INDEX].params.oneOf.0","typeLabel":"string[]"},{"type":"object","description":"Variables del template. Array para posicionales (`{{1}}`, `{{2}}`)\nu objeto para variables con nombre (`{\"nombre\": \"Juan\"}`).\n","additionalProperties":{"type":"string","uniqueKey":"recipients.items.[INDEX].params.oneOf.1.additionalProperties","typeLabel":"string"},"uniqueKey":"recipients.items.[INDEX].params.oneOf.1","typeLabel":"object"}],"uniqueKey":"recipients.items.[INDEX].params","typeLabel":"string[] | object"}},"uniqueKey":"recipients.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"recipients","typeLabel":"object[]"},"template_name":{"type":"string","description":"Nombre exacto del template aprobado. Requerido si no mandás `template_id`.","uniqueKey":"template_name","typeLabel":"string"},"template_language":{"type":"string","description":"Código de idioma (ej. `es_AR`). Requerido solo si el template existe en más de un idioma.","uniqueKey":"template_language","typeLabel":"string"},"template_id":{"type":"string","description":"ID del template (alternativa a `template_name`).","uniqueKey":"template_id","typeLabel":"string"},"external_ref":{"type":"string","description":"Tu referencia (ej. ID de presupuesto). Se devuelve en la respuesta y en el webhook de respuestas.","uniqueKey":"external_ref","typeLabel":"string"},"campaign_name":{"type":"string","description":"Nombre visible de la campaña en la plataforma. Default: `API - {template} - {external_ref}`.","uniqueKey":"campaign_name","typeLabel":"string"},"header_media_url":{"type":"string","description":"URL pública **https** del archivo del header. **Obligatorio si el template\ntiene header de imagen, video o documento (PDF)** — sin este campo el envío\ndevuelve 400. No se acepta base64: el archivo tiene que estar hosteado y ser\ndescargable sin autenticación. Límites de WhatsApp: imagen 5 MB (jpg/png),\nvideo 16 MB (mp4), documento 100 MB (PDF). Para documentos, el nombre del\narchivo se toma de la URL.\n","uniqueKey":"header_media_url","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"idempotency_key":"presupuesto-4812-followup-1","template_name":"seguimiento_presupuesto","template_language":"es_AR","external_ref":"PRES-4812","campaign_name":"Follow-up presupuesto 4812","recipients":[{"phone":"+5491123456789","params":["Juan","4812"]}]},"examples":{"Example":{"title":"Example","value":{"idempotency_key":"presupuesto-4812-followup-1","template_name":"seguimiento_presupuesto","template_language":"es_AR","external_ref":"PRES-4812","campaign_name":"Follow-up presupuesto 4812","recipients":[{"phone":"+5491123456789","params":["Juan","4812"]}]}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"39a073ef-9f8d-4605-b0ff-1c5b1132fdb3":{"description":"Envío ejecutado (o replay idempotente de un envío previo).","content":{"application/json":{"schema":{"type":"object","properties":{"campaign_id":{"type":"string","description":"ID del envío. Guardalo — viene en el webhook de respuestas.","uniqueKey":"campaign_id","typeLabel":"string"},"status":{"type":"string","enum":["sent"],"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"campaign_name":{"type":"string","uniqueKey":"campaign_name","typeLabel":"string"},"external_ref":{"oneOf":[{"type":"string","uniqueKey":"external_ref.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"external_ref.oneOf.1","typeLabel":"null"}],"uniqueKey":"external_ref","typeLabel":"string | null"},"recipients":{"type":"object","properties":{"added":{"type":"integer","uniqueKey":"recipients.added","typeLabel":"integer"},"duplicates":{"type":"integer","uniqueKey":"recipients.duplicates","typeLabel":"integer"},"errors":{"type":"array","items":{"type":"string","uniqueKey":"recipients.errors.items.[INDEX]","typeLabel":"string"},"uniqueKey":"recipients.errors","typeLabel":"string[]"}},"uniqueKey":"recipients","typeLabel":"object"},"replayed":{"type":"boolean","description":"`true` si esta respuesta es el replay de un envío previo con la misma idempotency_key.","uniqueKey":"replayed","typeLabel":"boolean"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"campaign_id":"\u003cstring>","status":"sent","campaign_name":"\u003cstring>","external_ref":"\u003cstring>","recipients":{"added":123,"duplicates":123,"errors":["\u003cstring>"]},"replayed":true}}},"exampleType":"generated"}},"exampleType":"generated"},"f9808c24-eb86-4b29-9ba4-b5ba757bde1d":{"description":"Input inválido (teléfono mal formado, template inexistente o no aprobado, sin destinatarios válidos, o envío en vuelo con la misma idempotency_key).","content":{"application/json":{"schema":{"type":"object","description":"Formato único de error de la API.","properties":{"code":{"type":"string","description":"`ERROR_CODE_INPUT_ERROR` (400), `ERROR_CODE_ACCESS_DENIED` (403), `ERROR_CODE_NOT_FOUND` (404), `ERROR_CODE_STANDARD_ERROR` (500).","uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"Descripción legible del error.","uniqueKey":"message","typeLabel":"string"},"payload":{"type":"object","description":"Contexto extra. En errores de envío incluye `campaign_id` (si la campaña llegó a crearse antes del fallo) y `external_ref`.","properties":{"campaign_id":{"oneOf":[{"type":"string","uniqueKey":"payload.campaign_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"payload.campaign_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"payload.campaign_id","typeLabel":"string | null"},"external_ref":{"oneOf":[{"type":"string","uniqueKey":"payload.external_ref.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"payload.external_ref.oneOf.1","typeLabel":"null"}],"uniqueKey":"payload.external_ref","typeLabel":"string | null"}},"uniqueKey":"payload","typeLabel":"object"}},"example":{"code":"ERROR_CODE_INPUT_ERROR","message":"Template 'seguimiento_presupuesto' not found or not APPROVED.","payload":{"campaign_id":null,"external_ref":null}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"ERROR_CODE_INPUT_ERROR","message":"Template 'seguimiento_presupuesto' not found or not APPROVED.","payload":{"campaign_id":null,"external_ref":null}}}},"exampleType":"generated"}},"exampleType":"generated"},"202fed49-e597-4505-b585-5483b0edbba1":{"description":"API key faltante o inválida.","content":{"application/json":{"schema":{"type":"object","description":"Formato único de error de la API.","properties":{"code":{"type":"string","description":"`ERROR_CODE_INPUT_ERROR` (400), `ERROR_CODE_ACCESS_DENIED` (403), `ERROR_CODE_NOT_FOUND` (404), `ERROR_CODE_STANDARD_ERROR` (500).","uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"Descripción legible del error.","uniqueKey":"message","typeLabel":"string"},"payload":{"type":"object","description":"Contexto extra. En errores de envío incluye `campaign_id` (si la campaña llegó a crearse antes del fallo) y `external_ref`.","properties":{"campaign_id":{"oneOf":[{"type":"string","uniqueKey":"payload.campaign_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"payload.campaign_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"payload.campaign_id","typeLabel":"string | null"},"external_ref":{"oneOf":[{"type":"string","uniqueKey":"payload.external_ref.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"payload.external_ref.oneOf.1","typeLabel":"null"}],"uniqueKey":"payload.external_ref","typeLabel":"string | null"}},"uniqueKey":"payload","typeLabel":"object"}},"example":{"code":"ERROR_CODE_INPUT_ERROR","message":"Template 'seguimiento_presupuesto' not found or not APPROVED.","payload":{"campaign_id":null,"external_ref":null}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"ERROR_CODE_INPUT_ERROR","message":"Template 'seguimiento_presupuesto' not found or not APPROVED.","payload":{"campaign_id":null,"external_ref":null}}}},"exampleType":"generated"}},"exampleType":"generated"},"dc715cee-a4d8-4d31-aa4e-13d60b7cf2ef":{"description":"Fallo aguas arriba (WhatsApp). Reintentá con la misma idempotency_key — no se duplica el envío.","content":{"application/json":{"schema":{"type":"object","description":"Formato único de error de la API.","properties":{"code":{"type":"string","description":"`ERROR_CODE_INPUT_ERROR` (400), `ERROR_CODE_ACCESS_DENIED` (403), `ERROR_CODE_NOT_FOUND` (404), `ERROR_CODE_STANDARD_ERROR` (500).","uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"Descripción legible del error.","uniqueKey":"message","typeLabel":"string"},"payload":{"type":"object","description":"Contexto extra. En errores de envío incluye `campaign_id` (si la campaña llegó a crearse antes del fallo) y `external_ref`.","properties":{"campaign_id":{"oneOf":[{"type":"string","uniqueKey":"payload.campaign_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"payload.campaign_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"payload.campaign_id","typeLabel":"string | null"},"external_ref":{"oneOf":[{"type":"string","uniqueKey":"payload.external_ref.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"payload.external_ref.oneOf.1","typeLabel":"null"}],"uniqueKey":"payload.external_ref","typeLabel":"string | null"}},"uniqueKey":"payload","typeLabel":"object"}},"example":{"code":"ERROR_CODE_INPUT_ERROR","message":"Template 'seguimiento_presupuesto' not found or not APPROVED.","payload":{"campaign_id":null,"external_ref":null}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"ERROR_CODE_INPUT_ERROR","message":"Template 'seguimiento_presupuesto' not found or not APPROVED.","payload":{"campaign_id":null,"external_ref":null}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"4f11b2e6-233c-497c-9617-a61362e83b78":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"API key provista por Xenda (formato `xnd_...`). Se envía en todas las llamadas.","scopes":[]}}},"servers":{"9591bc63-3924-412b-aecb-ca5069c20389":{"url":"https://api.automationhub.one/api:RIKjHOHm","description":"Producción"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","description":"API key provista por Xenda (formato `xnd_...`). Se envía en todas las llamadas.","scopes":[]},"schema":{"title":"X-API-Key","type":"string","description":"API key provista por Xenda (formato `xnd_...`). Se envía en todas las llamadas.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"X-API-Key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"xenda","siteName":"Xenda Partner API","title":"Enviar un template (campaña) - Xenda Partner API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-10T14:19:16.293Z","originalFileLocation":"api-reference/enviar-un-template-campaña.mdx"},"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=\"Una sola llamada crea la campaña, carga el/los destinatario(s) y ejecuta el envío. Devuelve el campaign_id que después llega en el webhook de respuestas. Idempotencia: si reintentás con la misma idempotency_key, no se duplica el envío — devolvemos la respuesta original con replayed: true. Ante un error 502, reintentá con la misma clave.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Xenda Partner API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/xenda/kFQj1Sn4H83Eozmw/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/xenda/kFQj1Sn4H83Eozmw/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/xenda/kFQj1Sn4H83Eozmw/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/xenda/kFQj1Sn4H83Eozmw/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/xenda/kFQj1Sn4H83Eozmw/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/xenda/kFQj1Sn4H83Eozmw/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/xenda/kFQj1Sn4H83Eozmw/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/xenda/kFQj1Sn4H83Eozmw/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/xenda/kFQj1Sn4H83Eozmw/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Enviar un template (campaña) - Xenda Partner API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Una sola llamada crea la campaña, carga el/los destinatario(s) y ejecuta el envío. Devuelve el campaign_id que después llega en el webhook de respuestas. Idempotencia: si reintentás con la misma idempotency_key, no se duplica el envío — devolvemos la respuesta original con replayed: true. Ante un error 502, reintentá con la misma clave.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Xenda Partner API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://partner-api.xenda.ai/api-reference/enviar-un-template-campaña\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://xenda.mintlify.app/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=Enviar+un+template+%28campa%C3%B1a%29\u0026amp;description=Una+sola+llamada+crea+la+campa%C3%B1a%2C+carga+el%2Flos+destinatario%28s%29+y+ejecuta%0Ael+env%C3%ADo.+Devuelve+el+%60campaign_id%60+que+despu%C3%A9s+llega+en+el+webhook+de%0Arespuestas.%0A%0A**I\u0026amp;theme=396d13e6644a1062fc958a72\u0026amp;signature=90f2e16275e003d5ca52de0f7901e58f713c6df29a900cf81c66095d0a3508fd\">\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=\"Enviar un template (campaña) - Xenda Partner API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Una sola llamada crea la campaña, carga el/los destinatario(s) y ejecuta el envío. Devuelve el campaign_id que después llega en el webhook de respuestas. Idempotencia: si reintentás con la misma idempotency_key, no se duplica el envío — devolvemos la respuesta original con replayed: true. Ante un error 502, reintentá con la misma clave.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://xenda.mintlify.app/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=Enviar+un+template+%28campa%C3%B1a%29\u0026amp;description=Una+sola+llamada+crea+la+campa%C3%B1a%2C+carga+el%2Flos+destinatario%28s%29+y+ejecuta%0Ael+env%C3%ADo.+Devuelve+el+%60campaign_id%60+que+despu%C3%A9s+llega+en+el+webhook+de%0Arespuestas.%0A%0A**I\u0026amp;theme=396d13e6644a1062fc958a72\u0026amp;signature=90f2e16275e003d5ca52de0f7901e58f713c6df29a900cf81c66095d0a3508fd\">\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=\"/mintlify-assets/_mintlify/favicons/xenda/kFQj1Sn4H83Eozmw/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Xenda Partner API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6D28D9\">\u003clink data-mint-head rel=\"canonical\" href=\"https://partner-api.xenda.ai/api-reference/enviar-un-template-campaña\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/enviar-un-template-campa%C3%B1a.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://partner-api.xenda.ai/#organization\",\"name\":\"Xenda Partner API\",\"url\":\"https://partner-api.xenda.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/xenda/MZRxpO0ybtOKSc2r/logo/logo_light.png?fit=max\u0026auto=format\u0026n=MZRxpO0ybtOKSc2r\u0026q=85\u0026s=e0fc539a255c677092c01ceedeb704cb\"}},{\"@type\":\"WebSite\",\"@id\":\"https://partner-api.xenda.ai#website\",\"name\":\"Xenda Partner API\",\"url\":\"https://partner-api.xenda.ai\",\"publisher\":{\"@id\":\"https://partner-api.xenda.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://partner-api.xenda.ai/api-reference/enviar-un-template-campa%C3%B1a#webpage\",\"url\":\"https://partner-api.xenda.ai/api-reference/enviar-un-template-campa%C3%B1a\",\"name\":\"Enviar un template (campaña)\",\"description\":\"Una sola llamada crea la campaña, carga el/los destinatario(s) y ejecuta el envío. Devuelve el campaign_id que después llega en el webhook de respuestas. Idempotencia: si reintentás con la misma idempotency_key, no se duplica el envío — devolvemos la respuesta original con replayed: true. Ante un error 502, reintentá con la misma clave.\",\"dateModified\":\"2026-07-10T14:19:16.293Z\",\"isPartOf\":{\"@id\":\"https://partner-api.xenda.ai#website\"},\"breadcrumb\":{\"@id\":\"https://partner-api.xenda.ai/api-reference/enviar-un-template-campa%C3%B1a#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://partner-api.xenda.ai/api-reference/enviar-un-template-campa%C3%B1a#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Xenda Partner API\",\"item\":\"https://partner-api.xenda.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Enviar un template (campaña)\",\"item\":\"https://partner-api.xenda.ai/api-reference/enviar-un-template-campa%C3%B1a\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://partner-api.xenda.ai/api-reference/enviar-un-template-campa%C3%B1a#apireference\",\"headline\":\"Enviar un template (campaña)\",\"name\":\"Enviar un template (campaña)\",\"description\":\"Una sola llamada crea la campaña, carga el/los destinatario(s) y ejecuta el envío. Devuelve el campaign_id que después llega en el webhook de respuestas. Idempotencia: si reintentás con la misma idempotency_key, no se duplica el envío — devolvemos la respuesta original con replayed: true. Ante un error 502, reintentá con la misma clave.\",\"url\":\"https://partner-api.xenda.ai/api-reference/enviar-un-template-campa%C3%B1a\",\"mainEntityOfPage\":{\"@id\":\"https://partner-api.xenda.ai/api-reference/enviar-un-template-campa%C3%B1a#webpage\"},\"dateModified\":\"2026-07-10T14:19:16.293Z\",\"publisher\":{\"@id\":\"https://partner-api.xenda.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://partner-api.xenda.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Xenda Partner API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Xenda Partner API","nav":{"global":null,"tabs":[{"tab":"Campañas de WhatsApp","groups":[{"group":"Empezar","pages":[{"title":"Introducción","href":"/introduccion"},{"title":"Autenticación","href":"/autenticacion"}]},{"group":"Webhooks","pages":[{"title":"Webhook de respuestas","description":"Recibí un POST en tu endpoint cada vez que un cliente responde a un template enviado por la API.","href":"/respuestas-webhook"}]},{"group":"API Reference","pages":[{"group":"API Reference","pages":[{"title":"Enviar un template (campaña)","deprecated":null,"version":null,"openapi":"/openapi.yaml post /campaigns","href":"/api-reference/enviar-un-template-campaña"},{"title":"Estado de un envío","description":"Estado en vivo de la campaña y de cada destinatario (envío, entrega,\nlectura y respuesta). Solo devuelve campañas creadas con tu API key.\nDevuelve hasta 100 destinatarios.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml get /campaigns/{campaign_id}","href":"/api-reference/estado-de-un-envío"},{"title":"Respuesta de un cliente","version":null,"deprecated":null,"openapi":"/openapi.yaml webhook reply.received","href":"/api-reference/respuesta-de-un-cliente"}]}]}]},{"tab":"POS Bridge","pages":[{"title":"POS Bridge","href":"/pos-introduccion"}]},{"tab":"Novedades","pages":[{"title":"Novedades","href":"/changelog"}]}]},"basePath":"","title":"Enviar un template (campaña) - Xenda Partner API","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}