Create New WhatsApp Template

API Endpoint

Use the following endpoint to create a new WhatsApp message template:

POST https://public.doubletick.io/template

Request Headers

{
  "Authorization": "YOUR_API_KEY",
  "Content-Type": "application/json"
}

Request Body Parameters

{
  "language": "en",
  "components": {
    "header": {
      "format": "TEXT",
      "text": "Header text"
    },
    "body": {
      "text": "Body Text"
    },
    "footer": {
      "text": "Footer Text"
    },
    "buttons": [
      {
        "type": "URL",
        "text": "Create New Template",
        "url": "https://your-file-url/file.jpg"
      }
    ]
  },
  "category": "UTILITY",
  "allowCategoryUpdate": true,
  "name": "your_template_name",
  "wabaNumbers": [
    "sender_number"
  ]
}

Parameters

• language (string, required): The language of the template.
• components (object, required): The structure of the template, including header, body, footer, and buttons.
  • header (object, optional): Can include text or media (image, video, document).
    • format (string, required): Header format (TEXT, IMAGE, VIDEO, DOCUMENT)
    • text (string, optional)
      • Length not exceed 60 characters.
  • body (object, required)
    • text (string, required)
      • Main text content with placeholders if needed.
      • Length not exceed 1024 characters.
  • footer (object, optional)
    • text (string, required)
      • Length not exceed 60 characters.
  • buttons (array of objects, optional)
    • type (string, required): List of interactive buttons (QUICK_REPLY, URL, PHONE_NUMBER).
    • text (string, required): Length to be in between 1 to 25 characters.
    • url (string, optional): Required if type selected as URL
    • phoneNumber (string, optional): Required if type selected as PHONE_NUMBER
• category (string, required): Template category (UTILITY, MARKETING).
• allowCategoryUpdate (boolean, optional): Allows Meta to auto-assign a category (default: true).
• name (string, required):
  • Unique name for the template.
  • Length to be in between 1 to 512 characters.
• wabaNumbers (array of strings, required): List of WhatsApp Business API numbers registered for messaging.

Response

Success Response (201)

{
  "success": true
}

Bad Request (400)

{
  "message": "error_message",
  "error": "Bad Request",
  "statusCode": 400
}

Unauthorized (401)

{
  "message": "Invalid public api key",
  "error": "Unauthorized",
  "statusCode": 401
}

Unprocessable Entity (422)

{
  "message": "invalid file type for audio: text/html; charset=utf-8",
  "error": "Unprocessable Entity",
  "statusCode": 422
}

Best Practices

• Choose a clear, descriptive template name.
• Use placeholders wisely for personalization.
• Follow WhatsApp's Business Messaging Policy to avoid rejection.