Create WhatsApp template

POST

https://numueg.app/api/v1/stores/{store_id}/whatsapp/templates

Last modified:2026-09-19 16:39:33

x-numu-scope:marketing:write

Submit a custom WhatsApp template to Meta for approval.

Phase 1 (FR-026 / EDIT-C / analyze HIGH-3): BYO-only.
Platform-managed stores cannot create custom templates — they share
NUMU's single Meta WABA, and per-merchant custom templates against
a shared WABA cause cross-store visibility + approval-budget
exhaustion. Platform-managed stores rely on the system-seeded
canonical templates (FR-030); custom templates require BYO.

Behavior:

Store mode = platform_managed → 403 template_submission_requires_byo.

Local duplicate (name + language) → 409.

Meta synchronous rejection → 422 with the sanitized Meta error
body (TASK-SEC-009 — fbtrace_id never surfaced); no local row.

Meta accept → 201 with the persisted PENDING row.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Successful Response

Bodyapplication/json

🟠422

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://numueg.app/api/v1/stores//whatsapp/templates' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "name": "string",
    "language": "ar",
    "category": "UTILITY",
    "header_type": "string",
    "header_content": "string",
    "body_text": "string",
    "footer_text": "string",
    "buttons": []
}'

Response Example

201 - Example 1

{
    "success": true,
    "data": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "store_id": "7fe87115-950c-4ae8-bd7e-970406bc9ac0",
        "meta_template_id": "string",
        "name": "string",
        "language": "string",
        "category": "UTILITY",
        "status": "PENDING",
        "header_type": "string",
        "header_content": "string",
        "body_text": "string",
        "footer_text": "string",
        "buttons": [],
        "is_system": false,
        "submitted_at": "2019-08-24T14:15:22.123Z",
        "approved_at": "2019-08-24T14:15:22.123Z",
        "rejection_reason": "string",
        "created_at": "2019-08-24T14:15:22.123Z",
        "updated_at": "2019-08-24T14:15:22.123Z"
    },
    "message": "string"
}

Modified at 2026-09-19 16:39:33

List WhatsApp templates

Delete WhatsApp template