How to connect LaunchSMS Reviews with Zapier

Overview

This documentation outlines how to integrate with the LaunchSMS Review API and the process for obtaining approval to access it. This API enables verified Zapier users to programmatically fetch and respond to customer reviews from both Google and Custom Reviews collected through the LaunchSMS platform.

🔐 API Access & Approval Process

Step 1: Request Access

To use this API via Zapier or any third-party tool:

You must have an approved API Key issued by LaunchSMS.
Only verified users with active companies on the platform are allowed.

Step 2: Approval Process

Submit a request through the LaunchSMS team for API access.
Include your:
- Company name
- Purpose of integration
- Email address associated with your LaunchSMS account
Once reviewed and approved, you will receive an API Key.

🔑 Authentication

All endpoints require a token (your API Key) passed as a parameter.

📥 Fetch Review Data (Zapier Trigger)

`GET /api/reviews`

Returns structured review and company data for display or automation purposes (Zapier Trigger).

Request Parameters:

Parameter	Type	Required	Description
`token`	string	✅	Your API key
`reviewStart`	int	❌	Pagination offset (default: 0)
`reviewCount`	int	❌	Number of reviews to return (default: 2)
`minReviewRate`	float	❌	Minimum average rating to filter reviews

Sample Request:

Sample Response:

json

{
  "success": true,
  "data": {
    "@type": "LocalBusiness",
    "name": "Your Company Name",
    "image": "https://example.com/uploads/company_logo/logo.png",
    "telephone": "123-456-7890",
    "url": "https://yourcompany.com",
    "address": {
      "@type": "PostalAddress",
      "streetAddress": "...",
      "addressLocality": "...",
      "addressRegion": "...",
      "postalCode": "...",
      "addressCountry": "USA"
    },
    "aggregateRating": {
      "@type": "AggregateRating",
      "ratingValue": 4.8,
      "reviewCount": 67,
      "chartData": {
        "count": { "5": 50, "4": 10, "3": 5, "2": 1, "1": 1 },
        "percentage": { "5": 74.6, "4": 14.9, "3": 7.5, "2": 1.5, "1": 1.5 }
      }
    },
    "reviews": [
      {
        "@type": "Review",
        "author": "John Doe",
        "datePublished": "2025-08-01",
        "description": "Amazing experience!",
        "name": "Great service",
        "reviewRating": {
          "@type": "Rating",
          "bestRating": 5,
          "worstRating": 1,
          "ratingValue": 5,
          "overallExperience": 5,
          "qualityOfService": 5,
          "serviceProvider": 5,
          "comfortNeeds": 5
        },
        "Responses": {
          "response": "Thank you for the kind words!"
        }
      }
    ]
  }
}

📤 Respond to Reviews (Zapier Action)

`POST /api/review/reply`

This endpoint allows Zapier (or an internal user) to post replies to a specific Google or Custom review.

Headers:

Authorization: Bearer {token} (If using OAuth flow)
Or send token via query string or form body

Body Parameters:

Parameter	Type	Required	Description
`review_id`	int	✅	ID of the review to reply to
`comment`	string	✅	Reply message
`type`	string	✅	Either `google` or `custom`

Sample Request:

Success Response:

🔍 Get Internal Review Data (Optional)

`GET /api/getReviews`

Use this endpoint to retrieve internal review data, if authenticated via session (e.g., web interface).

Parameters:

limit (default: 25)
page (default: 1)

Response:

Includes both Review and CustomReview model data.

📄 JSON-LD Compatibility

The primary /api/reviews response is compatible with schema.org’s LocalBusiness and AggregateRating formats, which can be used for rich snippets or SEO-based integrations.

✅ Zapier Approval Tips

When submitting for Zapier App Review, include:

Your endpoint documentation (like this!)
A working example of the trigger and action steps:
- Trigger: New Review (uses /api/reviews)
- Action: Reply to Review (uses /api/review/reply)
Instructions on generating or requesting an API Key.
Optional: Add a Zapier Auth test using a webhook or the API Key field.

Updated on August 6, 2025

Tagged: settings integrations

Was this article helpful?

Yes No

Overview

🔐 API Access & Approval Process

Step 1: Request Access

Step 2: Approval Process

🔑 Authentication

📥 Fetch Review Data (Zapier Trigger)

GET /api/reviews

Request Parameters:

Sample Request:

Sample Response:

📤 Respond to Reviews (Zapier Action)

POST /api/review/reply

Headers:

Body Parameters:

Sample Request:

Success Response:

🔍 Get Internal Review Data (Optional)

GET /api/getReviews

Parameters:

Response:

📄 JSON-LD Compatibility

✅ Zapier Approval Tips

Related Articles

Leave a Comment Cancel

`GET /api/reviews`

`POST /api/review/reply`

`GET /api/getReviews`