SMS Campaigns
The SMS Campaigns page lets you reach many contacts at once with a single text message, for marketing announcements, status notifications, follow-ups, and other bulk outbound SMS use cases. Each campaign is built with a multi-step wizard that captures the campaign's audience, content, schedule, and sender number, then runs the send according to the rate limits you set.
Table of Contents
- Access SMS Campaigns
- Before You Start
- Campaigns Table
- Campaign Detail Page
- Create a New Campaign
- Step 1: General
- Step 2: Contacts
- Step 3: Message
- Step 4: Schedule
- Step 5: Sender ID
- Step 6: Review
- Cost, Balance & Holds
- Compliance Review
- Sending Rate Limits
- SMS Campaigns FAQ
Access SMS Campaigns
In the PBX.IM Dashboard sidebar, open SMS & MMS → SMS Campaigns.
Before You Start
To send a campaign you need:
- At least one SMS-enabled phone number on your account. Buy or port a number from Call Routing → Phone Numbers first.
- (US/Canada only) An approved A2P 10DLC campaign registered under Settings → Channels → SMS. Numbers without an approved brand and campaign cannot be used as senders for US/CA traffic. See the A2P 10DLC Registration Guide.
- A Time Group that describes when sending is allowed. Create one under Call Routing → Time Conditions → Time Groups or directly from the campaign wizard. Time Groups respect your account's local timezone.
- One or more Phone Lists (contact lists) you want to send to. Manage them under Contacts.
- Enough account balance to cover the campaign. The estimated cost is held when the campaign starts. See Cost, Balance & Holds.
Campaigns Table
The main page shows every campaign on your account.
| Column | Description |
|---|---|
| Active | A switch that pauses or resumes the campaign (see Pause and Resume a Campaign) |
| Name | The internal name of the campaign |
| Labels | Tags used to group and filter campaigns |
| Status | Current state of the campaign (see Campaign Statuses) |
| Sent | Number of messages already sent |
| Delivered | Number of messages confirmed delivered (green when greater than zero) |
| Failed | Number of messages that failed to send or deliver (red when greater than zero) |
| Progress | Combined progress bar showing Sent / Delivered / Failed against the total recipients |
| Actions | Edit or delete the campaign (see Edit a Draft Campaign) |
Use the search box to find a campaign by name, and the label filter above the table to narrow the list to campaigns tagged with a specific label.
Click anywhere on a campaign row to open its detail page with live KPIs, a delivery chart, and a per-recipient log. The Active switch is the exception — clicking it toggles the campaign without opening it.
Click + Add SMS Campaign in the top right to launch the campaign wizard.
Campaign Statuses
The Status badge shows where a campaign stands.
| Badge | Meaning |
|---|---|
| Draft | Campaign was saved before completing the wizard. Open it again to finish setup |
| In Review | Submitted and waiting on a compliance review (see Compliance Review) |
| Approved | Passed compliance review and cleared to send |
| Scheduled | Approved and waiting for its next Time Group window |
| Active | Currently sending messages |
| Stopped | Sending has halted. This covers both a paused campaign, which can be resumed, and a cancelled one, which cannot |
| Completed | All recipients have been processed |
| Rejected | Sending was refused by compliance review, or blocked by carrier or A2P policy enforcement |
| Failed | The campaign could not run (e.g., sender number or A2P brand became invalid) |
[!NOTE] Paused and cancelled campaigns share the same Stopped badge. To tell them apart, look at the Active switch: it stays usable on a paused campaign so you can resume it, and is greyed out on a cancelled one.
Pause and Resume a Campaign
The Active switch in the first column stops and restarts a campaign without cancelling it. The same switch appears on the campaign detail page, to the left of the campaign name.
- Switch off — sending pauses. The campaign stops taking new recipients and the badge changes to Stopped.
- Switch on — sending resumes from where it stopped. No recipients are lost or re-sent.
The switch takes effect immediately, with no confirmation step, and the Status badge updates in place. If the change cannot be applied, the switch returns to its previous position and an error message explains why.
The switch only works while a campaign is Scheduled, Active, or Stopped (paused). It is greyed out for every other status — a Draft has not launched yet, and Completed, Cancelled, Rejected, Failed, In Review and Approved campaigns are not sending.
A campaign can also pause on its own if your balance drops below the held amount. That looks identical in the table: the switch goes off and the badge reads Stopped. Top up your balance and switch it back on. See Cost, Balance & Holds.
Edit a Draft Campaign
Only Draft campaigns can be edited. Hover a draft row and click the pencil icon in the actions column on the right to reopen the wizard, pre-filled with everything you saved. The pencil is hidden on every other status — once a campaign has been submitted for review, its content is locked.
The wizard opens on Step 1 with all six steps already filled in, so you can jump to the step you want to change. Steps you do not touch are left alone.
To discard a campaign you no longer want, use the trash icon instead.
Campaign Detail Page
Click a campaign name in the Campaigns Table to open its detail page. The page is read-only and does not replace the wizard. Use it to monitor a running or completed send, investigate which recipients failed, and confirm the cost of the campaign.
The page is composed of four sections, top to bottom.
Header
The left arrow returns to the campaigns table. To its right is the campaign name and a status badge that mirrors the Campaign Statuses.
KPI Cards
A grid of six cards summarizes campaign performance. Each card with a percentage shows a small radial dial of progress.
| Card | What it shows |
|---|---|
| Cost | Amount spent so far, formatted as spent of total. The dial fills as the campaign approaches the estimated total cost |
| Total contacts | The net recipient count for the campaign (the same number shown on the wizard Review step) |
| Sent | Messages submitted to the carrier. Dial shows percentage of total contacts |
| Delivered | Messages confirmed delivered to the recipient's device. Green dial |
| Failed | Messages that could not be delivered: invalid number, carrier rejection, blocked content, etc. Red dial |
| Opted-out | Recipients who replied with an Opt-Out Keyword and were removed from this campaign. Orange dial when greater than zero |
Counts update as the campaign progresses. Spend is deducted from the held amount in batches as messages are sent.
Campaign Stats Chart
A time-series view of Delivered (green) and Failed (red) messages over the life of the campaign.
| Control | Options | Behavior |
|---|---|---|
| Granularity | Per 15 min, Per hour, Per day | Bucket size for the timeline. Hidden when the chart type is pie |
| Chart type | Line, Bar (default), Pie | Bar stacks delivered + failed per bucket; Line shows two smoothed series; Pie shows the cumulative delivered-vs-failed split |
Hover over a bar, line point, or pie slice to see the per-bucket counts and percentage breakdown. If the campaign has not produced any stats yet (e.g., it is still in Scheduled), the chart area shows No data yet.
Delivery Log
A paginated, searchable table with one row per recipient.
| Column | Description |
|---|---|
| Phone | The recipient's phone number, formatted for the campaign's country |
| Status | A colored badge. See Recipient Statuses |
| Sent at | Timestamp the message was handed off to the carrier, or blank if not yet sent |
| Reason | For failed or suppressed rows, the underlying error from the carrier (e.g., invalid number, blocked content). Empty for successful rows |
Use the search box in the top right of the table to find a specific recipient by phone number.
Recipient Statuses
| Status | Meaning |
|---|---|
| Pending | Recipient is in the campaign but has not yet been queued |
| Queued | Queued for the carrier; waiting for the next Time Group window or rate slot |
| Sent | Submitted to the carrier; awaiting a delivery receipt |
| Delivered | Carrier confirmed delivery to the recipient's device |
| Failed | Carrier rejected the message or delivery failed. See the Reason column |
| Opted-out | Recipient replied with an Opt-Out Keyword; future messages from this campaign are skipped |
| Suppressed | Recipient was skipped because they appear on a Don't-Send-To list, or were filtered by another suppression rule |
Create a New Campaign
The wizard walks you through six steps. You can use the stepper at the top of the dialog to jump back to any previous step. Each step validates the fields it owns before you can move forward.
| Step | Purpose |
|---|---|
| 1. General | Name, description, labels, target country, A2P campaign |
| 2. Contacts | Phone Lists to include and exclude |
| 3. Message | Message body, tokens, opt-out message and keywords |
| 4. Schedule | When the campaign can send and how fast |
| 5. Sender ID | Which phone number sends the messages |
| 6. Review | Final confirmation and cost before launching |
If you close the wizard before finishing, a Cancel SMS Campaign confirmation appears. Confirming saves the campaign as a Draft so you can finish it later from the campaigns table.
Step 1: General
| Field | Required | Description |
|---|---|---|
| Campaign Name | Yes | 3 to 80 characters. Internal reference. Example: Black Friday Promo, US 2026 |
| Description | No | Up to 250 characters. Notes for other admins on what this campaign is for |
| Labels | No | Up to 10 labels. Create new labels inline. Used for grouping in the table |
| Country | Yes | The target country for the campaign. Determines which sender numbers are eligible and which rate caps apply |
| A2P Campaign | Yes for US/CA | Pick one of your Approved A2P 10DLC campaigns. Only shown when Country is United States or Canada |
[!NOTE] Changing the Country after picking an A2P Campaign or Sender ID clears those selections, because eligibility depends on country.
Step 2: Contacts
Pick the audience for your campaign from your existing Phone Lists.
Send To
Select one or more Phone Lists that should receive the message. The wizard shows the total number of contacts across the lists you pick. At least one Send-To list is required.
Don't Send To
Select Phone Lists that should be excluded from the send (e.g., a "do not contact" list, customers who already received this offer, churned accounts). Contacts that appear in both Send-To and Don't-Send-To lists are skipped.
A Phone List that is already chosen on one side is hidden from the other side's dropdown.
[!NOTE] Opt-outs are always suppressed. Anyone who has previously replied STOP is removed from the send automatically, system-wide. This cannot be bypassed, and it applies on top of any Don't-Send-To lists you choose.
Recipients Estimate
Once a Send-To list is selected, a green banner shows the net recipient count: the number of unique contacts the campaign will message after de-duplication and after removing anyone in the Don't-Send-To lists. The same estimate is reused on the Review step.
Step 3: Message
Compose the SMS body and define how recipients can opt out. For US/CA traffic the message must follow the disclosures and HELP/STOP behavior registered with your A2P campaign.
Message Body
Type the SMS content in the Message textarea. Below the textarea the wizard shows:
- A segment chip (e.g., 1 SEGMENT). One segment equals one billed SMS.
- A character counter in the form N / 150 Characters, showing how many characters fit in the current segment.
Messages longer than 150 characters are automatically split into multiple segments. The maximum is 10 segments (1,500 characters).
Important: the Opt-Out Message is appended to every outgoing message on a new line, and it counts toward your character and segment totals. A longer footer means fewer characters available for your message body.
Tokens
The TOKENS panel to the right of the textarea offers merge tokens that personalize each message. Click a token to insert it at the cursor position:
| Token | Replaced with |
|---|---|
{Name} | The contact's name |
{Phone} | The contact's phone number |
Tokens are always available, regardless of which Phone List you selected. At send time each token is replaced with that contact's value. If a contact has no value for a token, it is replaced with an empty string and the message still sends.
Tokens count toward the character total as their literal placeholder length (e.g. {Name} counts as 6 characters), because substitution happens at send time.
Opt-Out Message and Keywords
| Field | Required | Description |
|---|---|---|
| Opt-Out Message | Yes | A short footer appended to every message. Defaults to "To opt out of future messages, reply STOP." Maximum 60 characters. Required by carriers |
| Opt-Out Keywords | Yes | Comma-separated words that trigger an opt-out when a recipient replies with them. Defaults to STOP, CANCEL, UNSUBSCRIBE. Each keyword must be 2 to 20 characters; duplicates are removed regardless of casing |
[!NOTE] STOP is always on. Even if you remove it from the keyword list, a recipient replying STOP will always be opted out. This is a carrier requirement and cannot be disabled.
Step 4: Schedule
| Field | Required | Description |
|---|---|---|
| Time Group | Yes | A pre-configured time window (e.g., Mon to Fri, 9 AM to 5 PM). The campaign only sends inside this window. You can create a new Time Group from the dropdown |
| Messages Per Hour | Yes | The maximum number of messages the campaign will send in any rolling hour. Default: 500 |
| Messages Per Day | Yes | The maximum number of messages the campaign will send in any rolling day. Default: 4000 |
Rules:
- Hourly rate cannot exceed the daily rate.
- Both values must be positive integers.
- See Sending Rate Limits below for the maximums by country.
A Time Group can contain more than one sending window per day (for example 10:00 to 12:00 and 14:00 to 16:00). The campaign sends inside every window in the group.
Step 5: Sender ID
Pick the phone number that will appear as the From address on the recipients' phones.
Available Numbers
The Sender ID dropdown shows only SMS-enabled numbers that are eligible to send to the country you picked in Step 1.
- For US or Canada campaigns, only numbers attached to an Approved A2P Campaign are listed. A banner at the top of the step reminds you of this and links to Apply for A2P if you have no eligible numbers.
- For other countries, any SMS-enabled number on the account is eligible.
If no eligible numbers exist, you will see No A2P-approved numbers or No SMS-enabled numbers and must register or buy a number before continuing.
Inbox Destination
Once you pick a sender number, the wizard shows the Inbox Destination field: the inbox where inbound replies to that number will land. This field is read only here. To change it, click Edit next to the field to open that number's settings in Inbox and reassign it there.
Replies from campaign recipients arrive in that inbox as new conversations, so an agent can pick up the thread.
Step 6: Review
The Review step is split into two panels, followed by your account balance.
Summary
| Row | Value |
|---|---|
| Name | From Step 1 |
| Sender ID | From Step 5, formatted per your account's number formatting |
| Sending Rate | Shown as {per hour}/hour, {per day}/day |
| Scheduled | The sending window(s) from the Time Group you selected |
| Segments / SMS | Shown as {segments} ({characters} characters), e.g. 1 (128 characters) |
| A2P Campaign | From Step 1. Only shown for US/Canada campaigns |
Cost Estimation
| Row | Value |
|---|---|
| Contacts | Net contacts after suppression |
| Segments per message | From the Message step counter |
| Segment cost | Per-segment price for the destination country |
| Total cost | Contacts × Segments per message × Segment cost |
Amounts are shown in your account's billing currency.
Below the panels you'll see your Current balance. Click Launch to start the campaign, or use the stepper to go back and fix something.
Cost, Balance & Holds
Understanding how a campaign is paid for:
- Estimate. The Review step shows the total cost: Contacts × Segments per message × Segment cost.
- Hold. When you launch, the estimated total is held (reserved) against your account balance. That money is set aside for this campaign.
- Deduction. As messages go out, the cost is deducted from the held amount in batches.
- Auto-pause. If your balance drops below the held amount, the campaign pauses automatically and moves to Paused. Top up your balance to resume.
[!NOTE] Check your balance before launching a large campaign. A campaign that runs out of funds mid-send will pause rather than fail, but your recipients will receive the message in two batches, split by however long it takes you to top up.
Compliance Review
How a campaign is cleared to send depends on the country you target:
| Country | What happens |
|---|---|
| United States / Canada | You must select an Approved A2P 10DLC campaign in Step 1. Without one, the campaign cannot launch and you're directed to register |
| All other countries | The campaign is submitted for a compliance review. It's saved as Pending Review, our support team is notified, and you receive a confirmation email at your account address. Sending begins once it's approved |
Sending Rate Limits
The wizard enforces these per-country caps:
| Region | Max Per Hour | Max Per Day |
|---|---|---|
| United States, Canada (A2P) | 2,000 | 2,000 |
| Rest of the world | 10,000 | 100,000 |
These are upper limits enforced by the form. Your actual carrier throughput may be lower depending on the A2P campaign tier, brand reputation, and number type.
SMS Campaigns FAQ
Why is my number missing from the Sender ID dropdown?
For US or Canada campaigns, the number must be associated with an Approved A2P 10DLC campaign. For other countries the number must be SMS-enabled. Check Settings → Channels → SMS and Call Routing → Phone Numbers.
Can I send to multiple countries from the same campaign?
No. A campaign targets a single Country, which also gates which sender numbers and rate caps apply. Create separate campaigns per country.
How do I change where replies go?
Replies land in whatever inbox is linked to the sender number. Change the link from the Inbox settings of that phone number. The SMS Campaigns wizard surfaces an Edit shortcut to that screen.
What happens if a contact is in both Send-To and Don't-Send-To?
They are excluded. The Don't-Send-To list always wins.
Are messages sent outside the Time Group?
No. The campaign pauses sending outside the Time Group window and resumes inside it, subject to the hourly and daily rate caps.
How are messages billed?
Each segment equals one SMS billed. The wizard counts segments from the message body plus the opt-out footer, using a 150-character segment size, up to a maximum of 10 segments (1,500 characters) per message. Total cost = contacts × segments per message × segment cost.
What happens if I run out of balance mid-campaign?
The campaign pauses automatically and moves to Paused. Top up your balance and it will resume. No recipients are lost.
What do tokens do, and what if a contact is missing one?
Tokens ({Name}, {Phone}) are replaced with that contact's value at send time. If a contact has no value for a token, it's replaced with an empty string and the message still sends, so write your copy so it still reads correctly without the token.
What is the difference between Opt-Out Message and Opt-Out Keywords?
The Opt-Out Message is the footer appended to every outgoing message telling recipients how to opt out. The Opt-Out Keywords are the words PBX.IM watches for in inbound replies. A reply containing any keyword marks the contact as opted out and excludes them from future sends. STOP always works, whether or not it's in your list.
Can someone who opted out be added back by a new campaign?
No. Opt-outs are suppressed system-wide and cannot be overridden by adding the contact to a new Phone List.
Can I send MMS, images, or track link clicks?
Not currently. MMS/RCS, link shortening and click tracking, A/B message testing, and drip/sequence campaigns are not part of SMS Campaigns today.