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
| Environment | URL |
|---|---|
| Production | https://production-api.shoutaboutus.com |
| Development | https://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:
| Field | Type | Required | Description |
|---|---|---|---|
campaign_id | integer | yes | Must be an existing campaign inside your own account tree. |
customer_name | string | yes | max 255; trimmed before save. |
phone | string | yes | min 7, max 20; include country code. |
is_test | boolean | no | nullable; tagged onto audience + sms request rows. Defaults false. |
keywords | object | no | nullable 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
200{
"data": {
"status": "success",
"message": "SMS review request sent successfully"
}
}Errors
| Status | Meaning |
|---|---|
400 | The request was rejected — the response explains why |
401 | The bearer token is missing, expired or invalid |
403 | The token is valid but the record sits outside your account |
422 | The request failed validation — the response names the fields |
500 | Unexpected 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!"}}'Updated 11 days ago
Did this page help you?
