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.
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.
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.
POST to /contacts to add a customer’s name, phone number, email and an internal note to TrueReview without sending a request.
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.
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.
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 guidePass drip_campaign_set_id to choose which campaign sends the request. GET /get_drip_campaign_sets lists your campaigns and their IDs.
Download Postman collectionsRepeat customers won’t be asked over and over. Set the rules on each request, or let your location settings decide.
Pass resend_threshold_days to skip a phone number that already got a request within that many days.
Set exclude_clicked_customers to true to leave out customers who already clicked your review link.
Send your own fields with custom_attributes[attribute_key], using the keys from Dynamic Attributes in your TrueReview settings.
Three steps to your first request.
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.
Each business has its own Location SID. In Account Settings, click Manage next to the business, open Integrations & API and copy the SID.
Add both values as the Authorization and Location-Sid headers, then POST a customer’s phone number or email to /requests.
Real results from businesses that send review requests with TrueReview.

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

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

“Loving this product! Customers are finally leaving reviews after sending them the TrueReview link!”
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.
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.