---
updatedAt: 2026-04-24T10:23:33.000Z
agentTools:
  projectIndex: https://developer.reviews.io/llms.txt
---

# Queue Product SMS Invitation

This endpoint will create a Product Review invitation SMS.

Your price plan includes some SMS credits, additional credits can be purchased in your REVIEWS.io dashboard.  Please note that an SMS credit is 160 characters, if an SMS invitation message is over 160 characters then it'll use more than 1 SMS credit.

Product Review invitation SMS messages can also be created using our [SMS Booster](https://support.reviews.io/en/articles/3295697-sms-booster) feature.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "REVIEWS.io API",
    "version": "0.1"
  },
  "servers": [
    {
      "url": "https://api.reviews.io",
      "description": "REVIEWS.io API"
    },
    {
      "url": "https://api.reviews.co.uk",
      "description": "REVIEWS.co.uk API"
    }
  ],
  "paths": {
    "/product/sms/invitation": {
      "post": {
        "tags": [
          "Product Review Invitations"
        ],
        "summary": "Queue Product SMS Invitation",
        "operationId": "5bbf718fc8f6758cef7d10c6a6ca4d60",
        "parameters": [
          {
            "$ref": "#/components/parameters/store"
          },
          {
            "$ref": "#/components/parameters/apikey"
          }
        ],
        "requestBody": {
          "content": {
            "raw": {
              "schema": {
                "required": [
                  "customer_name",
                  "mobile_number",
                  "order_id",
                  "products"
                ],
                "properties": {
                  "customer_name": {
                    "description": "Customers name",
                    "type": "string",
                    "example": "Gerald"
                  },
                  "mobile_number": {
                    "description": "Customers phone number, in E.164 format",
                    "type": "string",
                    "example": "+44780000000"
                  },
                  "order_id": {
                    "description": "Customers order reference",
                    "type": "string",
                    "example": "#1234"
                  },
                  "message": {
                    "description": "Customize the message text. Placeholders: [name] [DomainName] [link]",
                    "type": "string",
                    "example": "Hi, thanks for choosing [DomainName]! We'd love to hear what you thought [link]."
                  },
                  "products": {
                    "title": "Products",
                    "description": "Products",
                    "type": "array",
                    "items": {
                      "$ref": "#/components/schemas/invitation_product"
                    }
                  }
                },
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "success": {
                      "description": "If the request succeeded",
                      "type": "string"
                    },
                    "message": {
                      "description": "Plaintext information on whether an Invitation was queued or not.",
                      "type": "string"
                    }
                  },
                  "type": "object",
                  "example": {
                    "success": "true",
                    "messages": ""
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "invitation_product": {
        "title": "Product to be reviewed",
        "description": "Product to be reviewed",
        "required": [
          "sku"
        ],
        "properties": {
          "sku": {
            "description": "Product Identifier",
            "example": "PR-123"
          },
          "name": {
            "description": "Product Name",
            "example": "Large T-Shirt in black"
          },
          "imageUrl": {
            "description": "Product Image",
            "example": "https://website.com/media/t-shirt-black.png"
          },
          "pageUrl": {
            "description": "Product Page URL",
            "example": "https://website.com/products/t-shirt-black"
          },
          "gtin": {
            "description": "GTIN",
            "example": "00001112234"
          },
          "mpn": {
            "description": "MPN",
            "example": "TSHIRT001"
          },
          "description": {
            "description": "description",
            "example": "description"
          },
          "category": {
            "description": "category",
            "example": "t-shirts"
          },
          "lookup": {
            "description": "Product Group - groups product reviews together",
            "example": "reviewsio-tshirt"
          }
        },
        "type": "object"
      }
    },
    "parameters": {
      "store": {
        "name": "store",
        "in": "query",
        "description": "Your REVIEWS.io public store key",
        "required": true,
        "schema": {
          "type": "string"
        }
      },
      "apikey": {
        "name": "apikey",
        "in": "query",
        "description": "Your REVIEWS.io private api key",
        "required": true,
        "schema": {
          "type": "string"
        }
      }
    }
  },
  "tags": [
    {
      "name": "Product Review Invitations",
      "description": ""
    }
  ],
  "x-readme": {
    "explorer-enabled": false
  }
}
```