---
title: "Create a review campaign"
method: POST
path: "/locations/review-campaigns"
tags: ["Review Campaigns"]
---

# Create a review campaign

`POST /locations/review-campaigns`

## Request

- Base URL: `https://api.synup.com/api/v4`
- URL: `https://api.synup.com/api/v4/locations/review-campaigns`
- Auth: none required
- TypeScript: <https://skmtc.dev/synup/apis/synup-api/docs/locations/review-campaigns/post.ts> (a function with typed inputs; its response is checked against the schema)

This API creates a review campaign to request customer reviews for a specific location.

**Behavior:**
- Sends review requests to customers via supported channels (e.g., email, SMS).
- Allows customization of campaign message and branding.
- Supports targeting options, such as specific customer segments.

## Headers

- `Authorization` string, required

## Request body

- CreateReviewCampaignRequest
  - `input` object, required
    - `locationId` string, required: Encoded Location ID
    - `name` string, required: Review Campaign Name
    - `locationCustomers` CustomerInputV2[], required: Campaign customers to create
      - `name` string, required
      - `email` string, email
      - `phone` string
    - `screening` boolean: Flag for screening enabled/disabled
    - `landingPageTemplate` LandingPageTemplateV2
      - `content` string
      - `heading` string
      - `reviewSiteHash` ReviewSiteV2[]
        - `name` string
        - `url` string: URL for connected sites (maps.google.com, facebook.com, foursquare.com) or custom sites
    - `openingEmailTemplate` EmailTemplateV3
      - `replyTo` string, email
      - `subject` string
      - `heading` string
      - `content` string
      - `reviewSiteHash` ReviewSiteV2[]: Not required when screening is true
        - `name` string
        - `url` string: URL for connected sites (maps.google.com, facebook.com, foursquare.com) or custom sites
    - `smsTemplate` SMSTemplateV2
      - `content` string
      - `reviewSiteHash` ReviewSiteV2[]: Max 1 for smsTemplate Not required when screening is true
        - `name` string
        - `url` string: URL for connected sites (maps.google.com, facebook.com, foursquare.com) or custom sites

## Response `200`

Successfully created review campaign

- object

## Other responses

- `403`: Insufficient permissions to create campaigns

---

[API](https://skmtc.dev/synup/apis/synup-api.md) - [All operations](https://skmtc.dev/synup/apis/synup-api/llms.txt) - [OpenAPI document](https://skmtc.dev/synup/apis/synup-api/revisions/67de2d51c22e?raw)