TrueReview API

Send review requests from your own software

The TrueReview API is a REST API with JSON responses. Create contacts and send Google review requests by SMS or email from your CRM, POS or any system you build.

Your app
Sale or job completed
TrueReview API
POST /requests
TrueReview
Review request sent
New Google review
Posted to your profile
5-star rating4.8+ rating · 2.5M+ review requests sent
What you can build

Create contacts and send review requests from your code

Every call uses HTTPS, your account access token and the Location SID of the business you want to send from. The current version is v1.

Send a review request

POST to /requests with a customer’s phone number or email, plus their name if you have it. TrueReview sends the Google review request by SMS or email and runs your follow-ups.

Create a contact

POST to /contacts to add a customer’s name, phone number, email and an internal note to TrueReview without sending a request.

Read your data

GET /requests returns each request with its status, campaign steps, rating and feedback. GET /contacts returns each contact with its name, phone, email and location.

Get started

TrueReview API endpoints

All endpoints start with https://app.truereview.co/api/v1 and take the Authorization and Location-Sid headers. Test them in Postman with the ready-made collections.

Endpoints

Select an endpoint to see the request and what it returns.

POSThttps://app.truereview.co/api/v1/requests
Request
curl -X POST https://app.truereview.co/api/v1/requests \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Location-Sid: YOUR_LOCATION_SID" \
  -F "customer_name=Mike Jones" \
  -F "customer_phone=281-330-8004" \
  -F "customer_email=mike@example.com" \
  -F "internal_note=This is a note"

Responses are JSON.

Fields you can send: POST /requests

FieldUseWhat it does
customer_phonePhone or emailMobile number for an SMS request.
customer_emailPhone or emailEmail address for an email request.
customer_nameOptionalThe customer's name.
internal_noteOptionalInternal note.
contact_type_idOptionalRequest type: 1 Direct Link, 2 Reactions, 3 Survey. Defaults to your location setting.
drip_campaign_set_idOptionalThe campaign that sends the request. Defaults to your location setting.
resend_threshold_daysOptionalSkip a phone number that got a request within this many days.
exclude_clicked_customersOptionalSet to true to skip customers who already clicked your review link.
custom_attributes[key]OptionalOne value per attribute key, for example custom_attributes[last.name].

Pick the request type

Pass contact_type_id to choose Direct Link (1), Reactions (2) or Survey (3). Leave it out to use the default from your location settings.

Read the API guide

Pick the campaign

Pass drip_campaign_set_id to choose which campaign sends the request. GET /get_drip_campaign_sets lists your campaigns and their IDs.

Download Postman collections
Built-in controls

Control who gets asked, and how often

Repeat customers won’t be asked over and over. Set the rules on each request, or let your location settings decide.

Resend threshold

Pass resend_threshold_days to skip a phone number that already got a request within that many days.

Skip customers who clicked

Set exclude_clicked_customers to true to leave out customers who already clicked your review link.

Custom attributes

Send your own fields with custom_attributes[attribute_key], using the keys from Dynamic Attributes in your TrueReview settings.

How it works

How to connect to the TrueReview API

Three steps to your first request.

Step 1

Generate your access token

Open the Integrations and API page in your TrueReview account and click Generate New Token. One token covers every location in your account, so keep it private.

Step 2

Copy your Location SID

Each business has its own Location SID. In Account Settings, click Manage next to the business, open Integrations & API and copy the SID.

Step 3

Send your first request

Add both values as the Authorization and Location-Sid headers, then POST a customer’s phone number or email to /requests.

Real customer results

What happens when you ask every customer

Real results from businesses that send review requests with TrueReview.

Classic Bakery
130 to 3,100+
Google reviews
5-star rating

“One of the most valuable out-of-the-box software solutions we have ever used.”

Areen Movsessian, Owner
New Life Foot and Body Spa
+557
new Google reviews
100% increase
5-star rating

“Integrates with our systems and dramatically improved reputation for my client”

Grant P., Marketing Manager
I Love To Drive
+630
new Google reviews
250% increase
5-star rating

“Loving this product! Customers are finally leaving reviews after sending them the TrueReview link!”

Mindy Collett, Owner
Keep exploring

More ways to connect

FAQ

TrueReview API questions, answered

Generate an access token on the Integrations and API page of your account and send it in the Authorization header. Add the Location-Sid header to choose which business the call applies to.

A unique ID for each business or location in your account. Copy it from Account Settings: click Manage next to the business, then open Integrations & API.

A phone number or email, sent as form data to POST /requests. The customer name, internal note, request type, campaign and resend rules are optional.

Yes. Pass contact_type_id for Direct Link, Reactions or Survey, and drip_campaign_set_id for the campaign. If you leave them out, TrueReview uses the defaults in your location settings.

You decide. Use resend_threshold_days to skip phone numbers contacted recently, and exclude_clicked_customers to skip customers who already clicked your review link.

API access is available on the most up to date Premium plan.

Yes. TrueReview connects to thousands of apps through Zapier, and to EHR and EMR systems through Keragon, with no code needed.

Get started

Send review requests straight from your own app

Try TrueReview free for 14 days, then connect your software with the TrueReview API.

14 days free. Cancel before it ends and you're never charged.