Test SMS review request

Overview

Create a one-off audience row and queue a single SMS review request for the given campaign (dispatched after commit on the messaging queue).

Prerequisites

  • A bearer token. Callable with Account tokens.

Base URL

EnvironmentURL
Productionhttps://production-api.shoutaboutus.com
Developmenthttps://development-api.shoutaboutus.com

Endpoint

POST /api/v1/campaign/test-sms-review-request

Authentication

  • Requires a bearer token in the Authorization: Bearer <bearer-token> header.

  • Who can call it: Account tokens.

  • Authentication, ACCOUNT-scope group.

  • If not owned by the caller it returns 403 ("You are not authorized to test this campaign").

  • The campaign must have an enabled SMS channel with a valid template.

  • The store must have an active plan, else 400.

Rate limit

  • No rate limit.

Request body

  • Body:
FieldTypeRequiredDescription
campaign_idintegeryesMust be an existing campaign inside your own account tree.
customer_namestringyesmax 255; trimmed before save.
phonestringyesmin 7, max 20; include country code.
is_testbooleannonullable; tagged onto audience + sms request rows. Defaults false.
keywordsobjectnonullable map; each key max 100 chars, values are strings. Empty/null values skipped; stored as recipient template placeholders.
{
  "campaign_id": 1,
  "customer_name": "John Doe",
  "phone": "+15551234567",
  "is_test": true,
  "keywords": {
    "paragraph_1": "Thanks for visiting our store today!"
  }
}

Response

  • data.status (string) — "success".
  • data.message (string).

200 OK · 200

{
  "data": {
    "status": "success",
    "message": "SMS review request sent successfully"
  }
}

Errors

StatusMeaning
400The request was rejected — the response explains why
401The bearer token is missing, expired or invalid
403The token is valid but the record sits outside your account
422The request failed validation — the response names the fields
500Unexpected server error

Example request

curl --request POST \
  --url "https://production-api.shoutaboutus.com/api/v1/campaign/test-sms-review-request" \
  --header 'Authorization: Bearer <bearer-token>' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{"campaign_id": 1, "customer_name": "John Doe", "phone": "+15551234567", "is_test": true, "keywords": {"paragraph_1": "Thanks for visiting our store today!"}}'

Did this page help you?