Mailrelay API Reference

Update a WhatsApp template

PATCH /whatsapp/templates/{id}

Update a WhatsApp template. Only templates with DRAFT or REJECTED status can be edited. Template name can only be changed for DRAFT templates.

Components Examples

Basic template:

{
  "components": [
    {
      "type": "BODY",
      "text": "Hello {{subscriber_name}}, welcome to our service!",
      "example": {
        "body_text_named_params": [{ "param_name": "subscriber_name", "example": "John" }]
      }
    }
  ]
}

Template with text header and footer:

{
  "components": [
    {
      "type": "HEADER",
      "format": "TEXT",
      "text": "Welcome to our service"
    },
    {
      "type": "BODY",
      "text": "Thank you for joining us!"
    },
    {
      "type": "FOOTER",
      "text": "Thank you for using our service"
    }
  ]
}

Template with buttons:

{
  "components": [
    {
      "type": "BODY",
      "text": "Visit our website to learn more!"
    },
    {
      "type": "BUTTONS",
      "buttons": [
        {
          "type": "URL",
          "text": "Visit Website",
          "url": "https://example.com"
        }
      ]
    }
  ]
}

Parameters

NameTypeDescription
id integer ID of the record
category string Category
language string Language
waba_id string WhatsApp Business Account
components array An array of template components. Must include exactly one BODY component. Optional components: HEADER (TEXT, IMAGE, VIDEO, or DOCUMENT format), FOOTER, and BUTTONS (up to 2 URL buttons).
header_media

Responses

StatusDescription
200 Success
400 The request is invalid. Check if the field names in the request and the request data is valid.
422 A validation error occurred. Check the response body for more information.
401 The API key wasn't sent or is invalid
500 An internal error happened. Try again later.