Add or Update Subscribers
add_subscribersAdd or update subscribers in Mobile Text Alerts (bulk operation)
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"subscribers": "<subscribers>"
},
"name": "add_subscribers"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| createOnly | No | When true, only create new subscribers and skip existing ones. When false, create new or update existing subscribers. | |
| subscribers | Yes | Array of subscribers to add/update (max 1000) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | Raw Mobile Text Alerts API response envelope, nested under `data.data`. IMPORTANT: partial failures are reported here, not via HTTP status — a call can return success with `errorRecordCount` above zero, so check `data.data.errorRecordCount` and `data.data.errorRecords` even when `success` is true. | |
| error | No | ||
| status | Yes | ||
| context | No | Additional context about why the call was blocked | |
| success | Yes | ||
| errorCode | No | Machine-readable error code. 'ONBOARDING_REQUIRED' means the account has not finished brand registration. 'NO_SENDING_NUMBER' means no number on the account can send yet; 'SENDING_NUMBER_NOT_FOUND' / 'SENDING_NUMBER_UNAVAILABLE' mean the requested `from` number is not on the account or can't send. 'AUTH_FAILED', 'RATE_LIMITED', 'UPSTREAM_ERROR' and 'UPSTREAM_UNAVAILABLE' are Mobile Text Alerts API failures. | |
| nextSteps | No | Explicit recovery guidance for the calling agent | |
| statusText | Yes |