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

  1. Access SMS Campaigns
  2. Before You Start
  3. Campaigns Table
  4. Campaign Detail Page
  5. Create a New Campaign
  6. Step 1: General
  7. Step 2: Contacts
  8. Step 3: Message
  9. Step 4: Schedule
  10. Step 5: Sender ID
  11. Step 6: Review
  12. Cost, Balance & Holds
  13. Compliance Review
  14. Sending Rate Limits
  15. 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:

  1. At least one SMS-enabled phone number on your account. Buy or port a number from Call Routing → Phone Numbers first.
  2. (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.
  3. 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.
  4. One or more Phone Lists (contact lists) you want to send to. Manage them under Contacts.
  5. 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.

ColumnDescription
ActiveA switch that pauses or resumes the campaign (see Pause and Resume a Campaign)
NameThe internal name of the campaign
LabelsTags used to group and filter campaigns
StatusCurrent state of the campaign (see Campaign Statuses)
SentNumber of messages already sent
DeliveredNumber of messages confirmed delivered (green when greater than zero)
FailedNumber of messages that failed to send or deliver (red when greater than zero)
ProgressCombined progress bar showing Sent / Delivered / Failed against the total recipients
ActionsEdit 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.

BadgeMeaning
DraftCampaign was saved before completing the wizard. Open it again to finish setup
In ReviewSubmitted and waiting on a compliance review (see Compliance Review)
ApprovedPassed compliance review and cleared to send
ScheduledApproved and waiting for its next Time Group window
ActiveCurrently sending messages
StoppedSending has halted. This covers both a paused campaign, which can be resumed, and a cancelled one, which cannot
CompletedAll recipients have been processed
RejectedSending was refused by compliance review, or blocked by carrier or A2P policy enforcement
FailedThe 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.

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.

CardWhat it shows
CostAmount spent so far, formatted as spent of total. The dial fills as the campaign approaches the estimated total cost
Total contactsThe net recipient count for the campaign (the same number shown on the wizard Review step)
SentMessages submitted to the carrier. Dial shows percentage of total contacts
DeliveredMessages confirmed delivered to the recipient's device. Green dial
FailedMessages that could not be delivered: invalid number, carrier rejection, blocked content, etc. Red dial
Opted-outRecipients 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.

ControlOptionsBehavior
GranularityPer 15 min, Per hour, Per dayBucket size for the timeline. Hidden when the chart type is pie
Chart typeLine, Bar (default), PieBar 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.

ColumnDescription
PhoneThe recipient's phone number, formatted for the campaign's country
StatusA colored badge. See Recipient Statuses
Sent atTimestamp the message was handed off to the carrier, or blank if not yet sent
ReasonFor 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

StatusMeaning
PendingRecipient is in the campaign but has not yet been queued
QueuedQueued for the carrier; waiting for the next Time Group window or rate slot
SentSubmitted to the carrier; awaiting a delivery receipt
DeliveredCarrier confirmed delivery to the recipient's device
FailedCarrier rejected the message or delivery failed. See the Reason column
Opted-outRecipient replied with an Opt-Out Keyword; future messages from this campaign are skipped
SuppressedRecipient 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.

StepPurpose
1. GeneralName, description, labels, target country, A2P campaign
2. ContactsPhone Lists to include and exclude
3. MessageMessage body, tokens, opt-out message and keywords
4. ScheduleWhen the campaign can send and how fast
5. Sender IDWhich phone number sends the messages
6. ReviewFinal 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

FieldRequiredDescription
Campaign NameYes3 to 80 characters. Internal reference. Example: Black Friday Promo, US 2026
DescriptionNoUp to 250 characters. Notes for other admins on what this campaign is for
LabelsNoUp to 10 labels. Create new labels inline. Used for grouping in the table
CountryYesThe target country for the campaign. Determines which sender numbers are eligible and which rate caps apply
A2P CampaignYes for US/CAPick 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:

TokenReplaced 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

FieldRequiredDescription
Opt-Out MessageYesA short footer appended to every message. Defaults to "To opt out of future messages, reply STOP." Maximum 60 characters. Required by carriers
Opt-Out KeywordsYesComma-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

FieldRequiredDescription
Time GroupYesA 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 HourYesThe maximum number of messages the campaign will send in any rolling hour. Default: 500
Messages Per DayYesThe 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

RowValue
NameFrom Step 1
Sender IDFrom Step 5, formatted per your account's number formatting
Sending RateShown as {per hour}/hour, {per day}/day
ScheduledThe sending window(s) from the Time Group you selected
Segments / SMSShown as {segments} ({characters} characters), e.g. 1 (128 characters)
A2P CampaignFrom Step 1. Only shown for US/Canada campaigns

Cost Estimation

RowValue
ContactsNet contacts after suppression
Segments per messageFrom the Message step counter
Segment costPer-segment price for the destination country
Total costContacts × 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:

  1. Estimate. The Review step shows the total cost: Contacts × Segments per message × Segment cost.
  2. Hold. When you launch, the estimated total is held (reserved) against your account balance. That money is set aside for this campaign.
  3. Deduction. As messages go out, the cost is deducted from the held amount in batches.
  4. 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:

CountryWhat happens
United States / CanadaYou must select an Approved A2P 10DLC campaign in Step 1. Without one, the campaign cannot launch and you're directed to register
All other countriesThe 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:

RegionMax Per HourMax Per Day
United States, Canada (A2P)2,0002,000
Rest of the world10,000100,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.

Not currently. MMS/RCS, link shortening and click tracking, A/B message testing, and drip/sequence campaigns are not part of SMS Campaigns today.