---
title: "List WhatsApp templates"
method: GET
path: "/v1/design_studio/whatsapp"
tags: ["WhatsApp"]
---

# List WhatsApp templates

`GET /v1/design_studio/whatsapp`

## Request

- Base URL: `https://api.customer.io`
- URL: `https://api.customer.io/v1/design_studio/whatsapp`
- Auth: none declared

Returns a paginated list of the WhatsApp templates you made in Design Studio and a separate array of the folders they belong to. Each item in the list is a summary that includes the template's Meta approval status. To see a template's content, category, language, recipient, and sender, [get the template](/integrations/api/design-studio/tag/whatsapp/getWhatsApp/).

The list doesn't include templates you created in your Meta account outside of Design Studio.

## Query parameters

- `page` integer
- `limit` integer
- `parent_folder_id` string, uuid
- `direct_descendants_only` boolean
- `sort_by` 'created' | 'updated' | 'name'
- `sort_order` 'asc' | 'desc'
- `created_before` integer
- `created_after` integer
- `updated_before` integer
- `updated_after` integer

## Response `200`

Successful response

- object
  - `whatsapp` object[]
    - `id` string, uuid: The UUID of the WhatsApp template.
    - `name` string: The friendly name your team sees for the template in Design Studio.
    - `is_template` boolean: Whether the item is a reusable Design Studio template rather than a message.
    - `is_linked` boolean: Whether you've linked the template to a workflow, like a transactional message, a one-time send, or an automation action.
    - `parent_folder_id` string, uuid, nullable: UUID of the folder that contains the template, or `null` if the template is at the root level.
    - `status` string: Meta's approval status for the template, like `PENDING`, `APPROVED`, or `REJECTED`. Meta reports status changes to Customer.io, which stores the latest one. The value is an empty string when you haven't submitted the template, and also when Customer.io couldn't look the status up. To tell those apart, [get the template's status](/integrations/api/design-studio/tag/whatsapp-approval/getWhatsAppStatus/).
    - `created` integer: When you created the template, as a Unix timestamp in seconds.
    - `updated` integer: When the template last changed, as a Unix timestamp in seconds.
  - `folders` Folder[]
    - `id` string, uuid: ID of folder
    - `name` string: The name of the folder.
    - `parent_folder_id` string, uuid, nullable: The ID of the parent folder. Returns `null` if there is no parent, which means the folder is in the root directory.
    - `created` integer: Timestamp of when the folder was created.
    - `updated` integer: Timestamp of last update to the folder.
  - `meta` ListMeta
    - `pagination` object
      - `page` integer: The page number of results you're on.
      - `limit` integer: The number of results per page.
      - `total` integer: The total number of folders.
    - `filters` object: The filters applied in your request.

## Other responses

- `400`: The request is invalid due to malformed parameters, missing required fields, or constraint violations.
- `401`: Authentication failed due to a missing or invalid API key.
- `404`: The requested resource was not found.

## Changes

- **2026-10-28** `f33c07c62301`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference/changes/v1/design_studio/whatsapp/get.md)

---

[API](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference.md) - [All operations](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference/revisions/ac0b282053fe?raw)