> ## Documentation Index
> Fetch the complete documentation index at: https://docs.contactbutton.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Reviews

> Send review requests to contacts through email, SMS, and WhatsApp with consented delivery, tracked links, and public destinations like Google and Yelp.

Reviews is workspace-scoped and link-based. Add the public review pages a workspace wants to promote. Then invite existing contacts, leads, and inbox participants through the same email, Telnyx SMS, and Meta WhatsApp services already connected to the workspace.

Google Business Profile synchronization is not required. A Google review or profile URL works like any other configured destination.

## Review destinations

Use `GET /workspaces/{workspace}/review-destinations` to list the configured Google, Yelp, Facebook, Trustpilot, Tripadvisor, Better Business Bureau, Nextdoor, Foursquare, Houzz, or G2 links. The primary destination is returned first and is the default in the dashboard.

## Request a review

Create requests with `POST /workspaces/{workspace}/review-requests`. Every request requires an existing Contact, a configured destination, a delivery channel, and confirmation that the Contact consented to messages on that channel.

* `email` sends a branded invitation to the Contact's email address.
* `sms` sends from the workspace's configured SMS-capable Telnyx number.
* `whatsapp` sends from the workspace's connected Meta WhatsApp Business account. Supply the UUID of an approved template returned by the channel template endpoints.

SMS copy and WhatsApp template parameters can use `{contact}`, `{business}`, and `{review_link}`. The generated link records the click before redirecting to the selected review site.

```json theme={null}
{
  "contact_id": "31e63fd8-87ec-46bb-837c-ea0a347a86f5",
  "destination_id": "cdb65ffd-087a-4d54-8524-4cf6ef6cc25a",
  "channel": "email",
  "message": "Thanks for choosing us. We would appreciate your feedback.",
  "consent_confirmed": true,
  "consent_source": "checkout"
}
```

Send an `Idempotency-Key` header when creating a request so a network retry cannot create a second invitation.

## Delivery state

`GET /workspaces/{workspace}/review-requests` returns the latest channel state: queued, sent, delivered, read where supported, clicked, or failed. A click means the Contact opened the tracked link; it does not claim that the destination accepted a review.


## Related topics

- [Queue a consented review request](/api-reference/reviews/queue-a-consented-review-request.md)
- [List configured public review-site destinations](/api-reference/reviews/list-configured-public-review-site-destinations.md)
- [List email, SMS, and WhatsApp review requests](/api-reference/reviews/list-email-sms-and-whatsapp-review-requests.md)
- [Contact Button webhooks](/guides/webhooks.md)
- [Changelog](/changelog.md)