---
title: REVIEWS.io API Integration on Truto
slug: reviewsio
category: Marketing Automation
canonical: "https://truto.one/integrations/detail/reviewsio/"
---

# REVIEWS.io API Integration on Truto



**Category:** Marketing Automation  
**Status:** Beta

## MCP-ready AI tools

Truto exposes 28 tools for REVIEWS.io that AI agents can call directly.

- **list_all_reviews_io_company_invitations** — List Company Invitations. Filters (order_id, invite_sent) are sent as query parameters; REVIEWS.io documents them as a JSON body on this GET. The connector pages through all results (100 per page by default; pass limit for smaller pages).
- **create_a_reviews_io_company_invitation** — Queue Company Invitation. Legacy endpoint; invitations.create queues product and company invitations together. Required: name, email, order_id.
- **update_a_reviews_io_company_invitation_by_id** — Edit Company Invitations. Edit a queued company invitation, e.g. change its send date or set status to inactive to cancel it. Required: id.
- **create_a_reviews_io_company_review_tag** — Tag a Company Review. Required: company_review_id, tag.
- **list_all_reviews_io_company_reviews** — Retrieve Company Reviews. Legacy endpoint for company (store) reviews. Pages start at 0. The connector pages through all results (100 per page by default; pass limit for smaller pages).
- **create_a_reviews_io_company_sms_invitation** — Queue Company SMS Invitation.
- **create_a_reviews_io_invitation** — Queue Product and Company Invitations. Queues a product review invitation and, unless disabled in the dashboard, a company review invitation for the same order. Required: name, email, order_id, products.
- **list_all_reviews_io_product_invitations** — List Product Invitations. Filters (sku, order_id, invite_sent) are sent as query parameters; REVIEWS.io documents them as a JSON body on this GET. The connector pages through all results (100 per page by default; pass limit for smaller pages).
- **create_a_reviews_io_product_invitation** — Queue Product invitation. Legacy endpoint; invitations.create covers product and company invitations together. Required: name, email, order_id, products.
- **update_a_reviews_io_product_invitation_by_id** — Edit Product Invitations. Edit a queued product invitation, e.g. change its send date or set status to inactive to cancel it. Required: id.
- **list_all_reviews_io_product_ratings** — Retrieve Product Ratings. Required: sku (comma-separated list of SKUs).
- **create_a_reviews_io_product_review_tag** — Tag a Product Review. Required: product_review_id, tag.
- **list_all_reviews_io_product_review_votes** — Add to the vote count of a product. Note: despite being a GET, this ADDS one helpful vote to the review (it is not read-only). Required: product_review_id. Returns a single object: success, the review id and the updated vote count.

- **list_all_reviews_io_product_reviews** — Retrieve Product Reviews. Legacy endpoint for the reviews of one or more products. Required: sku (semicolon-separated for several, e.g. sku1;sku2). The connector pages through all results (100 per page by default; pass limit for smaller pages).

- **create_a_reviews_io_product_review** — Create a new Product Review. Required: sku, name, email, rating, review.
- **create_a_reviews_io_product_sms_invitation** — Queue Product SMS Invitation.
- **create_a_reviews_io_question** — Create a new Question.
- **list_all_reviews_io_review_nuggets** — Retrieve Review Nuggets. Required: types.
- **list_all_reviews_io_review_stats** — Retrieve Basic Review Statistics. Returns a single stats object, not a list.

- **list_all_reviews_io_reviews** — Retrieve Reviews and Questions. Without an API key, type is required (e.g. store_review or product_review). The connector pages through all results (100 per page by default; pass limit for smaller pages).
- **list_all_reviews_io_survey_responses** — Retrieve Survey Responses. Required: campaign_id.
- **list_all_reviews_io_surveys** — Retrieve Surveys.
- **create_a_reviews_io_unsubscribe** — Unsubscribe a user from REVIEWS.io invitation emails. Required: email.
- **list_all_reviews_io_unsubscribes** — Retrieve unsubscribed users.
- **list_all_reviews_io_user_generated_content** — Retrieve User Generated Content.
- **create_a_reviews_io_webhook** — Add a review submitted Webhook. Required: type, url.
- **list_all_reviews_io_webhooks** — List all Webhooks. The connector pages through all results (100 per page by default; pass limit for smaller pages).
- **delete_a_reviews_io_webhook_by_id** — Remove a review submitted Webhook. Required: id.

## How it works

1. **Link your customer's REVIEWS.io account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app.
2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request.
3. **Call Truto's API to reach REVIEWS.io.** The Proxy API is a 1-to-1 mapping of the REVIEWS.io API.
4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field.

## Use cases

- **Trigger review invitations from real delivery events** — Shipping, OMS, and fulfillment SaaS platforms can fire REVIEWS.io email or SMS invitations the moment a carrier marks a package delivered, dramatically increasing review conversion rates compared to time-based guesses.
- **Sync negative reviews into support ticketing workflows** — Helpdesk and customer support SaaS can register webhooks to ingest new reviews in real time, auto-create high-priority tickets for low-star ratings, and push resolution tags back to REVIEWS.io once agents close the loop.
- **Reward customers for leaving reviews and UGC** — Loyalty and rewards SaaS can detect verified reviews and user-generated content (photos/videos) and automatically credit loyalty points, driving repeat engagement from already-happy customers.
- **Enrich CRM and email segments with review sentiment** — CDP, CRM, and email marketing SaaS can pull review stats, product ratings, survey responses, and review nuggets to build satisfaction-based segments and inject social proof into campaigns.
- **Keep suppression lists GDPR/CCPA compliant across tools** — Marketing and CRM platforms can two-way sync REVIEWS.io unsubscribes with their own suppression lists, ensuring customer opt-outs are honored everywhere without manual reconciliation.

## What you can build

- **Delivery-triggered invitation automation** — Automatically queue company or product review invitations (email or SMS) using order ID and SKU data the instant a shipment is confirmed delivered.
- **Real-time review webhook listener** — Programmatically register and manage REVIEWS.io webhooks on behalf of your users so new reviews stream into your product without polling.
- **Low-star review ticket router** — Convert incoming negative reviews into prioritized support tickets and write back tags like 'resolved' or 'shipping-delay' to the original review.
- **Historical review and UGC backfill** — Page through all historical company reviews, product reviews, user-generated content, and survey responses to seed analytics dashboards and customer profiles on initial connection.
- **Loyalty points for verified reviews** — Detect new product reviews with attached UGC and automatically grant reward points, badges, or tier upgrades inside your loyalty platform.
- **Rating-powered email personalization** — Pull aggregated product ratings and review nuggets to dynamically inject top-rated items and star ratings into abandoned cart and post-purchase email flows.

## FAQs

### How do end users authenticate their REVIEWS.io account?

Truto handles the REVIEWS.io credential exchange and token storage for you. Your users connect their account once through Truto's connection flow, and your product calls the integration without managing API keys or refresh logic directly.

### Can we send both email and SMS review invitations?

Yes. You can create company email invitations, product email invitations, and SMS variants for both company and product reviews, or use the combined invitation endpoint that queues product and company invites together based on order ID and SKUs.

### How do we get reviews in real time instead of polling?

Use the webhook endpoints to register a URL on behalf of your user. REVIEWS.io will push review events to Truto, which forwards normalized payloads to your service. You can also list and delete webhooks for lifecycle management.

### Can we tag reviews from our own system?

Yes. Both company reviews and product reviews support tag creation, so you can write back labels such as 'actioned', 'refund-issued', or 'shipping-delay' from your support, CRM, or ops workflows.

### What historical data can we backfill on initial connection?

You can list all company reviews, product reviews, product ratings, review stats, review nuggets, user-generated content, survey responses, invitations, and unsubscribes — enough to hydrate dashboards, customer profiles, and sentiment analytics.

### How do we respect customer opt-outs across systems?

The unsubscribe endpoints let you create new opt-outs in REVIEWS.io and list existing ones, so you can bidirectionally sync suppression state with your email, CRM, or CDP platform to stay GDPR/CCPA compliant.

### Can we submit reviews or questions programmatically?

Yes. You can create product reviews and submit questions directly via the API, which is useful for migrations from other review platforms or for in-app review capture flows embedded in your product.
