---
title: "Create a WhatsApp Business text template"
method: POST
path: "/api/v1/tools/create_business_template"
---

# Create a WhatsApp Business text template

`POST /api/v1/tools/create_business_template`

## Request

- Base URL: `https://whatsync.app`
- URL: `https://whatsync.app/api/v1/tools/create_business_template`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Submit a new text-only UTILITY or MARKETING template to Meta for review. This creates a real template on the connected Business account; Meta decides its category and approval status. Use get_business_template later to check it. No WhatSync approval page is involved. Uses the Meta WhatsApp Business Management API message templates endpoint: https://developers.facebook.com/docs/whatsapp/business-management-api/message-templates

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `idempotencyKey` string, required: Unique key for this intended action. Reuse exactly on retries; use a new key only for a new action.
  - `name` string, required: Lowercase template name with underscores
  - `language` string, required: Template language, for example en_US
  - `category` 'UTILITY' | 'MARKETING', required
  - `body` string, required
  - `bodyExamples` string[]: One sample value for each numbered body variable, in order
  - `header` string
  - `footer` string

## Response `200`

JSON result. Every response includes X-Request-Id.

- object

## Other responses

- `400`: API error
- `401`: API error
- `403`: API error
- `404`: API error
- `409`: API error
- `413`: API error
- `415`: API error
- `422`: API error
- `429`: API error
- `503`: API error

---

[API](https://skmtc.dev/whatsync/apis/whatsync-api.md) · [All operations](https://skmtc.dev/whatsync/apis/whatsync-api/llms.txt) · [OpenAPI document](https://skmtc.dev/whatsync/apis/whatsync-api/revisions/6fa5498b63b7?raw)
