Skip to content

Knowledge Base

Business Process Automation Platform

What are the Error Codes for the Send Text Message Tool?


This article describes the error codes that are logged to the BPA Platform Event Log when a text message fails to be sent.

NOTE: This only applies if you are using the Send Text Message tool with the Provider set to ToucanText Message Gateway.

Errors are written to the Event Log using the format:

Error Code: <error_code>
Number: <mobile_number> 
From:  <sender>
Message: <text_message> 
Source Task Information: 
TaskName: <task_name>
TaskId: <ID> 
TimeOfSubmission: <date_time_stamp>


  • error_message is as below.
  • error_code is as below.
  • mobile_number is the attempted destination mobile number.
  • sender is the source address set in the global configuration — refer to the product help.
  • text_message is the text message body.
  • Source Task Information contains details of the task that sent the failed message. Note that the date_time_stamp is from when the task first submitted the message, not when it was re-attempted (either manually or otherwise).

Error Codes

The following error codes are logged to the Event Log by the Send Text Message tool:

Error CodeError MessageDescription
0OK, no error
1UnknownAn unknown error has occured. Contact Support for more information.
2Syntax errorA syntax error has been found in the message envelope; this could be in any element.
3LoginThe user credentials for the Message Gateway account (in the global configuration; refer to the product help) are incorrect. These must be corrected before the message queue can continue.
4Already boundContact our Support department if this error is seen.
5Invalid argumentsAn error has been found in either the message envelope’s properties.
6Invalid commandAn error has been found in the message envelope’s commands.
7Invalid message idThe text message contains an invalid ID.
8Invalid destination addressThe destination mobile number cannot be reached. Typically, this is because the number is too short or is a blank mobile number for example.
9Invalid source addressThe source address configured in the global configuration (refer to the product help) contains invalid charcters.
10No accessContact our Support department if this error is seen.
11Message errorThere is a problem with the text message contents or the message envelope.
12Invalid responseAn invalid response has been received from the provider to the Message Gateway.
13Communication errorData
14Database errorThis refers to the database used by the Message Gateway. Contact Support for more information.
15UDH errorAn error has been detected in the User Data Header of the text message; typically it contains problematic unicode data.
16No credits leftThe credits on the ToucanText account has expired; contact your business partner or account manager.
17BusyThe Message Gateway has halted the queue until it has free resources to continue.
18Too longThe text message body has exceeded the maximum size, which is 918 bytes; typically this is 1 byte per character but some can take up more. You must reduce the size of the erroring text message before re-queuing the message.
19ExpiredContact our Support department if this error is seen.
20No routeA destination route for the text message cannot be found.

Error Codes for Messages That Stop the Message Queue

If one of the following errors is seen, the Send Text Message tool attempts to resend the message every 15 minutes up to 120 minutes by default. After 120 minutes, the message queue is halted and an error written to the Event Log. Text messages will continue to be added to the queue; user intervention is required to resolve the error. Note that the Message Gateway Agent service must be restarted for the queue to start processing after the error has been resolved.

  • 1
  • 3
  • 10
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20

Error Codes for Single Message Failure

The following error codes indicate a problem with a particular text message. However, text messages that come after it will not be held up.

  • 2
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 11