---
title: "POST /v1/whatsapp/template/create"
method: POST
path: "/v1/whatsapp/template/create"
---

# POST /v1/whatsapp/template/create

`POST /v1/whatsapp/template/create`

Creates a new WhatsApp message template using a template from Meta's template library.

## Request body

- object
  - `metaLibraryTemplate` object, required — Represents a template from Meta's library with customization options.
    - `templateName` string — The name to assign to the template.
    - `libraryTemplateName` string — The name of the template in Meta's library.
    - `templateCategory` string — The category of the template (for example, UTILITY or MARKETING).
    - `templateLanguage` string — The language code for the template (for example, en_US).
    - `libraryTemplateButtonInputs` LibraryTemplateButtonInput[] — Button customizations for the template.
      - `type` string — The type of button (for example, QUICK_REPLY, CALL, or URL).
      - `phoneNumber` string — The phone number in E.164 format for CALL-type buttons.
      - `url` object — The URL with dynamic parameters for URL-type buttons.
      - `otpType` string — The type of one-time password for OTP buttons.
      - `zeroTapTermsAccepted` boolean — When true, indicates acceptance of zero-tap terms for the button.
      - `supportedApps` SupportedApp[] — List of supported applications for this button type.
    - `libraryTemplateBodyInputs` object — Body text customizations for the template.
      - `addContactNumber` boolean — When true, includes a contact number in the template body.
      - `addLearnMoreLink` boolean — When true, includes a "learn more" link in the template body.
      - `addSecurityRecommendation` boolean — When true, includes security recommendations in the template body.
      - `addTrackPackageLink` boolean — When true, includes a package tracking link in the template body.
      - `codeExpirationMinutes` integer — The number of minutes until a verification code or OTP expires.
  - `id` string, required — The ID of the WhatsApp Business Account to associate with this template.

## Response `200`

Success

- CreateWhatsAppMessageTemplateFromLibraryOutput
  - `metaTemplateId` string — The numeric ID assigned to the template by Meta.
  - `templateStatus` string — The status of the created template (for example, PENDING or APPROVED).
  - `category` string — The category of the template (for example, UTILITY or MARKETING).

## Other responses

- `480` — ValidationException
- `481` — AccessDeniedException
- `482` — ResourceNotFoundException
- `483` — InvalidParametersException
- `484` — AccessDeniedByMetaException
- `485` — ThrottledRequestException
- `486` — InternalServiceException
- `487` — DependencyException

---

[API](https://skmtc.net/aws/apis/socialmessaging.md) · [All operations](https://skmtc.net/aws/apis/socialmessaging/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/socialmessaging/versions/127e73cd9a15/schema)