CUcustomer
WhatsApp

Update a WhatsApp template

Changed on

Update a WhatsApp template's name, folder, category, language, content, recipient, or sender. You only need to send the fields you want to change; Customer.io keeps the current value of any field you leave out.

Meta reviews a template's content, category, and language. After you submit the template to Meta, you can't change those three fields unless Meta rejects the template. To change an approved template, create a new template and submit that one instead. You can change the name, folder, recipient, and sender at any time.

Renaming a template only changes the name your team sees in Design Studio. It doesn't rename the template you submitted to Meta.

put/v1/design_studio/whatsapp/{id}

Request

  • Base URL
    https://api.customer.io
  • URL
    https://api.customer.io/v1/design_studio/whatsapp/{id}
  • Auth
    none declared

Path parameters

idstring uuid required

The UUID of the WhatsApp template.

Request body

namestring

A new friendly name for the template.

parent_folder_idstring uuid nullable

UUID of the folder you want to move the template into. Pass null to move the template to the root level.

category'MARKETING' | 'UTILITY'

The new Meta template category.

languagestring

The new Meta language code, like en_US.

contentstring

The new template, written as WhatsApp markup. See the content field on Create a WhatsApp template for the format.

recipientstring

New liquid that resolves to the WhatsApp phone number of the person you're messaging, like {{customer.phone}}.

sender_idinteger nullable

The ID of the WhatsApp sender identity to send the template from. Pass null to clear the sender.

Example request

{
  "name": "Order shipped",
  "category": "MARKETING",
  "language": "en_US",
  "content": "<x-whatsapp><x-wa-body>Hi {{customer.first_name}}, your order is out for delivery.</x-wa-body></x-whatsapp>",
  "recipient": "{{customer.phone}}",
  "sender_id": 4
}

Response

WhatsApp template updated, no content returned

Changes