Switchboard Error Codes

Last updated: August 26, 2025

When you send a broadcast, some messages may not deliver successfully — this is expected. Remember, Switchboard doesn't charge you for any messages that return an error code.

The below table explains the most common error codes. To see error codes for all messages, you can export broadcast results at the bottom of each broadcast page, use our SQL Mirror, or use our API.

Feel free to reach out to support@oneswitchboard.com if you have any questions or want information about an error code that isn’t described below.

Starting September 2, 2025 Switchboard, will use a standard set of error codes across our downstream providers for consistency and interpretability.

Error Codes (After September 2, 2025)

Switchboard is set up to work with a few different downstream providers for sending out text messages. When you send out a broadcast on Switchboard, we send those messages to a downstream provider (such as Bandwidth or Infobip), who then sends the messages to phone carriers, who then attempts to deliver the message to a person's handset (mobile device). At each of these steps, it is possible that a message fails for some reason, and we receive an error code back from the provider. In those cases, we try to provide the most useful information possible back to you, in the form of an error code and error message.

Because each of these codes look slightly different across the different providers we use and phone carriers, we attempt to standardize them into common and consistent errors, as shown in the table below, to make it easier for you to understand what's happening.

Handset Error Codes

Error codes received from the handset (phone or mobile device) directly. These are very rare.

Error Code	Error Message
HA0001	SB_HANDSET_DELIVERY_ERROR_UNKNOWN
HA0002	SB_HANDSET_MARKED_AS_SPAM	The phone rejected the phone message as spam.
HA0003	SB_HANDSET_REJECTED	The handset rejected the phone message.

Carrier Error Codes

Error codes we receive from the phone carrier. These usually mean the carrier rejected the message or was unable to deliver it to the handset.

CA0001	SB_CARRIER_DELIVERY_ERROR_UNKNOWN
CA0002	SB_CARRIER_MARKED_AS_SPAM	The carrier has marked this traffic as spam.
CA0003	SB_CARRIER_REJECTED	The carrier has rejected the message but did not provide a specific reason.
CA0004	SB_CARRIER_REJECTED_MESSAGE_MAYBE_BLOCKED	In cases where we suspect traffic is blocked, we assign this error code.
CA0005	SB_CARRIER_REJECTED_OPT_OUT	The carrier has rejected the traffic to a phone that previously opted out.
CA0006	SB_CARRIER_PROVISIONING_ERROR	The carrier has rejected sending from a number that is not fully provisioned for sending.
CA0007	SB_CARRIER_CAMPAIGN_ERROR	There is an issue with the 10DLC campaign (The Campaign Registry).

Provider Error Codes

Error codes we receive from the aggregation provider. These generally indicate that the provider has rejected the message for formatting issues, spam errors, or in rare cases, phone number provisioning issues.

PV0001	SB_PROVIDER_DELIVERY_ERROR_UNKNOWN
PV0002	SB_PROVIDER_MARKED_AS_SPAM	The provider has marked this traffic as spam.
PV0003	SB_PROVIDER_REJECTED	The provider has rejected the message but did not provide a specific reason.
PV0004	SB_PROVIDER_DELIVERY_PENDING	The provider is attempting to send the message but there is a delay.
PV0005	Not in use
PV0006	SB_PROVIDER_PROVISIONING_ERROR	The number is not fully provisioned for sending.

Switchboard Error Codes

These are error codes reserved for issues with the destination phone or the attached media for MMS messages.

SB0001	SB_DELIVERY_ERROR_UNKNOWN
SB0002	SB_PHONE_INVALID_NUMBER	The destination phone number is invalid.
SB0003	SB_PHONE_LANDLINE_OR_UNREACHABLE	The destination phone is a landline or cannot be reached.
SB0004	SB_PHONE_CANNOT_RECEIVE_MESSAGES	The destination phone cannot receive messages, sometimes because it is not on the network.
SB0005	SB_MESSAGE_MEDIA_ERROR	The attached media cannot be sent.
SB0006	SB_MESSAGE_MEDIA_TOO_LARGE	The size of the attached media exceeds limits from the carrier or provider.

Error Codes (Before September 2025)

Prior to September 2025, we used different error codes and error messages to represent why a message failed to deliver. These were more direct error codes from a provider, but as we've set up the ability to send through more providers, we've now centralized on a standard set of error codes (above) to make it easier for you to interpret and understand what's happening if a message fails.

	Error Name	Description	New Error Code
4750	Carrier Rejected Message	The destination carrier has rejected the message but did not provide a specific reason. For AT&T traffic, this could be a prepaid user whose account is out of money or a subscriber that is provisioned to not receive this type of SMS.	CA0003
9999	Unknown Error	Carrier reported an unknown failure. Similar to a 4750 error.	SB0001
5620	Carrier Application Error	The upstream carrier has reported that they cannot process this message. Try sending again, and if the failure persists update your message.	CA0001
4700	Invalid Service Type	The phone number you are trying to reach does not support SMS or MMS.	CA0003
21614 or 9902	Timed out waiting for delivery receipt.	Our vendor did not provide the requested delivery receipt. If we receive it from them later, we will update the broadcast results.	SB0002 or PV0004
30005	Unknown Destination Handset	The destination number you are trying to reach is unknown and may no longer exist, or the the device you are trying to reach does not have sufficient service.	SB0003
30006	Unknown Destination	The destination number is unable to receive this message. Potential reasons could include trying to reach a landline or, in the case of short codes, an unreachable carrier.	SB0003
30007	Spam Detected	The carrier has determined that this message is spam related. Reach out to support@oneswitchboard.com if you feel this failure was given in error.	CA0002
30024	Provisioning Error	A message was sent to a number that was not fully provisioned or your sending number has not been fully provisioned for sending.	CA0006
21211	Invalid Number	The number has an invalid format.	SB0002
21408	Sending Permission Denied	The number you are trying to reach is out of range (i.e. out of the country).	SB0002