Skip to main content

List Message Templates

List Message Templates lists a WhatsApp Business Account's message templates, one page at a time. Pass the previous page's paging.cursors.after as After (cursor) to get the next page.

It calls GET https://graph.facebook.com/v23.0/{wabaId}/message_templates.

The activity has four tabs: Configuration, Auth, Input and Output.

Configuration​

FieldRequiredDescription
NameOptionalName of the step, should be unique within this workflow.
DescriptionOptionalDescribe the purpose or function of this step.
WABA IDOptionalWhatsApp Business Account id. Not the app id or phone number id. Sent as the wabaId path parameter; Meta needs it.
FieldsOptionalComma-separated template fields. Keep id and rejected_reason. Defaults to id,name,status,language,category,parameter_format,components,rejected_reason,quality_score. Sent as the fields query parameter.
Page SizeOptionalTemplates per page. Defaults to 100. Sent as limit.
After (cursor)OptionalCursor from the previous page; empty for the first page. Sent as after.
Status FilterOptionalReturns only templates in this status: APPROVED, PENDING, REJECTED, PAUSED, DISABLED, …. Sent as status.
Name FilterOptionalReturns only the template with this exact name. Sent as name.

Leave After (cursor), Status Filter and Name Filter empty to list every template from the first page.

Auth​

FieldRequiredDescription
Auth TypeOptionalOAuth 2, the only option. WhatsApp uses the Meta OAuth connection.
WhatsApp ConnectionOptionalThe WhatsApp resource, which needs the whatsapp_business_management scope.

Input​

This activity is built on the REST Client. It sends no request body; the values above go in the URL. You can also map pathParams.wabaId and the queryParams values from an earlier step here.

FieldRequiredData TypeDescription
TargetRequiredObjectThe HTTP request.

Output​

The activity returns an httpResponse object (status.code, status.message, headers, body). The response body carries:

FieldData TypeDescription
data[].idStringTemplate id. Use it with Get and Edit Message Template.
data[].nameStringTemplate name.
data[].statusStringAPPROVED, IN_APPEAL, PENDING, REJECTED, PENDING_DELETION, DELETED, DISABLED, PAUSED, LIMIT_EXCEEDED or ARCHIVED.
data[].languageStringLanguage code, for example en_US.
data[].categoryStringUTILITY, MARKETING or AUTHENTICATION.
data[].parameter_formatStringNAMED or POSITIONAL.
data[].componentsArrayHeader, body, footer and buttons.
data[].rejected_reasonStringNONE, ABUSIVE_CONTENT, CATEGORY_NOT_AVAILABLE, INCORRECT_CATEGORY, INVALID_FORMAT, PROMOTIONAL, SCAM or TAG_CONTENT_MISMATCH.
data[].quality_scoreObjectscore and date.
paging.cursors.before / afterStringCursors for the previous and next page.
paging.nextStringPresent when there's another page.