# Create new review template for given location Ids

Creates a review template. When email is present the template type is EMAIL and the locations' businesses need the REVIEW_GENERATION_EMAIL product plan feature; when email is absent the template type is SMS (REVIEW_GENERATION_SMS). For EMAIL templates every review link must have a label.

Endpoint: POST /customer-engagement/review-template
Version: 20260701

## Request fields (application/json):

  - `name` (string, required)
    Display name of the review template

  - `locationIds` (array, required)
    Ids of the locations this template applies to. The locations' businesses need the matching product plan feature (REVIEW_GENERATION_EMAIL or REVIEW_GENERATION_SMS).

  - `bodyText` (string, required)
    Message body of the review request

  - `senderName` (string)
    SMS sender name (3-11 characters), used for SMS templates

  - `email` (object)
    Email settings. When present the template type is EMAIL and every review link needs a label; when absent the template type is SMS.

  - `email.senderEmailId` (string, required)
    Sender email address. Must be a verified email identity (see the /identities endpoints).

  - `email.footerText` (string, required)
    Footer text shown at the bottom of the review request email

  - `email.subject` (string, required)
    Subject line of the review request email

  - `email.actionButtonColor` (string, required)
    Hex color of the call-to-action button
    Example: #3C8ECB

  - `email.privacyLink` (string, required)
    URL of the privacy policy linked from the email

  - `email.mediaIds` (array)
    Ids of previously uploaded media (see the review-template media upload-url endpoint), e.g. the logo shown in the email

  - `reviewLinks` (array, required)
    Review platform links offered to the customer

  - `reviewLinks.url` (string, required)
    URL of the review platform, or the name of a location custom field that holds the URL per location. Yelp is not supported.

  - `reviewLinks.label` (string)
    Display label of the review link. Required for every review link when email is present on the template.

## Response 200 fields (application/json):

  - `id` (integer)

  - `type` (string)

  - `name` (string)

  - `locationIds` (array)

  - `bodyText` (string)

  - `senderName` (string)

  - `email` (object)

  - `email.senderEmailId` (string, required)

  - `email.footerText` (string, required)

  - `email.subject` (string, required)

  - `email.actionButtonColor` (string, required)

  - `email.privacyLink` (string)

  - `email.media` (array)

  - `email.media.mediaId` (integer)

  - `email.media.message` (string)

  - `email.media.uploadUrl` (string)

  - `reviewLinks` (array)

  - `reviewLinks.url` (string, required)

  - `reviewLinks.label` (string)

  - `createdAt` (string)

  - `updatedAt` (string)

  - `errors` (array)

  - `message` (string)

## Response 500 fields (application/json):

  - `id` (integer)

  - `type` (string)

  - `name` (string)

  - `locationIds` (array)

  - `bodyText` (string)

  - `senderName` (string)

  - `email` (object)

  - `email.senderEmailId` (string, required)

  - `email.footerText` (string, required)

  - `email.subject` (string, required)

  - `email.actionButtonColor` (string, required)

  - `email.privacyLink` (string)

  - `email.media` (array)

  - `email.media.mediaId` (integer)

  - `email.media.message` (string)

  - `email.media.uploadUrl` (string)

  - `reviewLinks` (array)

  - `reviewLinks.url` (string, required)

  - `reviewLinks.label` (string)

  - `createdAt` (string)

  - `updatedAt` (string)

  - `errors` (array)

  - `message` (string)