Errors

Notifier error codes listing all exceptions thrown by the API

All error messages will be thrown with a 400 HTTP status.

Account Errors

Code 1001

Your API token does not have permission to Send an SMS.

Ask your account administrator to make you a new token with the Send SMS privileges.

Code 1002

Your API token does not have permission to View an SMS.

Ask your account administrator to make you a new token with the View SMS privileges.

Code 1003

You have ran out of credits on your account.

In order to continue you must add credits via your dashboard. Once you have added credits you can retry and failed messages as well as continuing to use paid endpoints.

Code 1004

You must have a validated Sender ID to be able to send SMS messages. In your account area, choose settings from the menu and input a sender name for SMS message. It will then need verifying by Notifier. The verification process should not take long.

Menu > Settings > SMS Sender Name

Code 1005

Your Default Sender ID is pending verification. We verify Sender IDs as a security procedure to ensure the quality of SMS we are sending from the platform.

Code 1006

You are trying to use a sender that is unapproved. Make sure you only use the sender field to send approved senders. You can also leave it blank to use your default sender name.

SMS API Errors

Code 2001

You need to provide a field with they key to containing the recipient's phone number, including international dialing code.

Code 2002

You must include the international dialing code at the front of the recipient's phone number with the leading 0 dropped from the front.

For example

07700 900389 should be presented as [phone]

Code 2003

Mobile phone numbers, in international form with a leading + are 13 digits in length. If the number you are providing is more than that, it is likely you have kept the leading 0.

For example

07700 900389 should be presented as [phone]

Case 2004

Phone numbers should only be made up of digits (apart from the leading + symbol) and should contain no alphabetical characters.

Code 2005

You must provide a body field containing the message you want to send.

Please refer to the SMS API Documentation

Code 2006

The maximum length of an SMS should be no greater than 1024 characters.

Code 2007

When passing over your own message ID you must pass a UUID. You can use the following tool to generate a UUID:

https://www.uuidgenerator.net/version1

Code 2008

When passing a message UUID, you must not use one you have used before. The odds of you getting this error by chance are one in a few tens of trillions so it's very likely you have sent the same UUID over before if you are seeing this!

Contact API Errors

Code 3001

You must provide a field with the key firstname.

Please refer to the Contact API Documentation

Code 3002

The firstname key must be a string

Code 3003

You must provide a field with the key lastname.

Please refer to the Contact API Documentation

Code 3004

The lastname key must be a string