Sakari error codes

Code Friendly description Detailed description and troubleshooting
ACCT-001 You have exceeded your free account limit  
ACCT-002 Invalid plan specified  
ACCT-003 Customer does not exist in payment system  
ACCT-004 Unable to change plan  
ACCT-005 Invalid top-up amount; the minimum amount is $10  
ACCT-006 Insufficient credit available

The requested message could not be sent because your Sakari account has insufficient credit (measured in dollars).

Unsent messages are queued for 72 hours. Suspended messages are sent automatically if credit is added before this time has passed.

To send suspended messages, log in to your Sakari account:

To clear suspended messages, contact our support team at: help@sakari.io

ACCT-007 Could not find account by payment system id  
ACCT-008 Account ID is invalid  
ACCT-009 Account is not able to be topped-up  
ACCT-010 IP Address is blocked  
ACCT-011 Email domain is blocked  
ACCT-012 You can only mark contacts as pre-approved on paid plans  
ACCT-013 Invalid account name  
ACCT-014 Plan changes must be made on the primary account  
ACCT-015 Can not update this property for this integration  
ACCT-016 Insufficient access to this API  
ACCT-017 Account must be verified by our staff prior to upgrading/topping-up to prevent SPAM usage. A member of staff will review and contact you within 24 hours  
ACCT-018 Account information used to populate anti-spam page has not been setup  
ACCT-019 Invalid auto top-up amounts  
ACCT-020 Account must have an active subscription  
ACCT-021 User does not have access to any phone numbers or groups  
ACCT-022 Gmail users cannot be added to unverified accounts  
ACCT-023 Top-ups are no longer supported on Pay and Go plans. Please upgrade to a subscription plan  
ACCT-024 We have detected an unusual volume of accounts created by this email domain. Please submit a ticket with our support team if you believe this is incorrect.  
AUTH-001 User does not have access to specified account  
AUTH-002 Non-matching account id  
AUTH-003 Temporary access has expired  
AUTH-004 Email is not verified  
AUTH-005 User must be an administrator to access this endpoint  
AUTH-006 User does not have sufficient permissions to access this endpoint

Occurs when:

  • a user does not have a Sakari profile and attempts to send a message
  • a user's profile does not have the required permissions (i.e. Read-Only)

Check that each user interacting with Sakari has an individual user log-in profile in Sakari.

If they don't, create one for them by following the steps in Configure a user in Sakari. They'll receive an invitation email and instructions on how to set up a password.

Since 12 December 2022, users interacting with Sakari are required to have a user account in Sakari.

Adding more users will not affect your billing.

CALL-001 From field is missing  
CALL-002 Destination field is missing  
CAM-001 Campaign must have field mappings  
CAM-002 Campaign must have a template  
CAM-003 Invalid campaign id  
CAM-004 Uploaded file contains no valid contacts  
CAM-005 Invalid campaign request  
CONT-001 Invalid mobile number

The carrier has rejected the message as an invalid destination address. This could mean the number is not in the domestic numbering plan (e.g. the area code does not exist, or the number is false), or the number is not enabled for messaging (e.g. a landline). 

Additionally, for Toll-Free messages to T-Mobile, this means the user has opted to block all text messaging. 

CONT-002 Invalid country  
CONT-003 Invalid country for mobile number  
CONT-004 Invalid contact id  
CONT-005 Self-registration not supported; please enable this feature in account settings   
CONT-006 Contact is invalid  
CONT-007 CSV must contain a column titled 'mobile'  
CONT-008 Contact already exists  
CONT-009 Invalid merge strategy  
CONT-010 Contact has requested no further communication  
CONT-011 No phone number supplied  
CONT-012 Destination number not reachable  
CONT-013 No route available to destination  
CONT-014 Number is not capable of receiving SMS The phone number has been identified as not being able to receive text messages.  This generally indicates that the phone number has been identified as a landline phone number that is not capable of receiving text messages. 
CONT-015 Country is not supported for sending SMS  
CONT-016 Account prohibits sending to this country  
CONT-017 Number is not in service  
CONT-018 Contact tracking not available  
CONV-001 Invalid conversation ID  
CONV-002 Unable to create conversation  
CONV-003 Unable to find an available phone number

Sakari is unable to find a supported outbound phone number with which to send your message.

This generally occurs for one of three reasons:

  • International messaging to an unsupported country
  • Non-active telephone number
  • Group incorrectly defined in HubSpot workflow

Please refer to CONV-003 for troubleshooting steps.

CONV-004 Contact must be specified  
CONV-005 Inbound phone number is not active  
DOM-001 A domain is required  
DOM-002 Domain is associated with active links; remove/update them to delete domain  
DOM-003 Domain already exists and is active within our system  
DOM-004 Domain not found  
GEN-001 No ID supplied  
GEN-002 Invalid request  
GEN-003 Item not found  
GEN-004 Invalid ID  
GEN-005 Max number of generated ids reached  
GRP-001 Group not found  
GRP-002 User does not have any mapped groups or phone numbers  
GRP-003 Group is required  
HOOK-001 Invalid webhook url  
INSI-001 Start date must be a valid date  
INSI-002 End date must be a valid date  
INSI-003 Start date must come before or equal to today and end date  
INT-001 Integration is not active  
INT-002 Provider is not enabled for destination country  
INT-003 Integration appears to have been disconnected  
INT-004 User does not have permissions to this contact. Must be contact owner  
INT-005 AirCall appears to have been disconnected

Your AirCall integration may be disconnected. From the Settings menu, navigate to Integrations > Aircall

  • If the AirCall integration is not connected, please reconnect it.
  • If the integration is connected, the integration credentials likely need to be refreshed.  Please disconnect the integration and reconnect it. 
INT-006 HubSpot appears to have been disconnected

Your HubSpot integration may be disconnected. From the Settings menu, navigate to Integrations > HubSpot. 

  • If the HubSpot integration is not connected, please reconnect it.
  • If the integration is connected, the integration credentials likely need to be refreshed.  Disconnect and then reconnect the integration, using the credentials of an active user in both Sakari and HubSpot.
INT-007 Pipedrive appears to have been disconnected

Your Pipedrive integration may be disconnected. From the Settings menu, navigate to Integrations > Pipedrive.

  • If the Pipedrive integration is not connected, please reconnect it.
  • If the integration is connected, the integration credentials likely need to be refreshed.  Disconnect and then reconnect the integration, using the credentials of an Administrator user in both Sakari and Pipedrive.
INT-008 Unable to update Slack Notifications  
INT-009 Unable to parse contact owner attributes  
INT-010 Active subscription to Intercom required  
INT-011 Intercom appears to have been disconnected  
INT-012 Twilio appears to have been disconnected

Sakari cannot connect with your Twilio account.  Things to check for:

  • Verify the Twilio Account SID and Auth Token are correct
  • Verify the correct Twilio Account (or sub-account) is being accessed
  • Ensure the Account is active, not suspended or closed
  • Ensure no extra characters or spaces are being included
  • Ensure the API Key's Twilio Region matches the request's specified Twilio Region
INT-013 ActiveCampaign API Key or API URl are invalid  
INT-014 Sakari does not have permission to view tickets in HubSpot  
INT-015 Slack channel no longer exists or is inaccessible  
INT-016 CallRail API key is no longer valid  
INT-017 Slack appears to have been disconnected  
INT-018 Pipedrive account is no longer active - possible expiration of trial or non-payment  
INT-019 Contact does not exist  
INT-020 Sakari does not have permission to add reactions to messages in Slack  
INT-021 ActiveCampaign account is no longer active - possible expiration of trial or non-payment  
INT-022 AirCall has not configured this number correctly for SMS  

INT-024

Unable to connect to integration. Please check your credentials and try again

The credentials provided could not be verified by the connecting integration.

When generating new credentials, log in to the connecting integration using the same email address used to log in to Sakari.

INT-026 Sakari does not have permission to read custom objects in HubSpot

A required scope is missing from the original authorization between Sakari and HubSpot.
 
This typically occurs when HubSpot releases new features or permissions (like support for custom objects), which were not part of the original integration scopes.

From the Settings menu, navigate to Integrations > HubSpot.

  • If the HubSpot integration is not connected, please reconnect it.
  • If the integration is connected, the integration credentials likely need to be refreshed.  Disconnect and then reconnect the integration, using the credentials of an active user in both Sakari and HubSpot.
JOB-001 Too many parallel conversations requested. Upgrade your account to increase limit  
JOB-002 Could not find execution  
LINK-001 Short link not found  
LINK-002 Destination Url required when creating or updating a short link  
MSG-001 Unable to find an available phone number  
MSG-002 Invalid message id  
MSG-003 Could not find message  
MSG-004 Could not find active conversation for message  
MSG-005 Missing job id  
MSG-006 Unknown provider error  
MSG-007 Message is too long

Your message has been rejected by the carriers or Sakari for being too long, or too large, for two common reasons:

  • Image attachments exceed carrier limits - Reduce the total file size of the attached image(s) to no more than 500 KB.
  • Message exceeds 10 SMS segments - SMS messages are limited to no more than 10 segments in length.  As a general rule, try to keep messages to 2-3 segments.

Use our free SMS Length Calculator to check the length of the message in segments.

MSG-008 Message marked as SPAM by carrier The carrier has identified your message as SPAM. Review the SMS Deliverability Guidelines and update your message before sending again.
MSG-009 Message prohibited by carrier  
MSG-010 Missing contact ID, conversation ID or list of contacts  
MSG-011 You can only send up to 100 messages. Reduce the number of contacts or create a campaign  
MSG-012 This message has been identified as spam or contains images or links which are not supported on unverified trial accounts. Please contact us at help@sakari.io to verify your account.

All Sakari trial accounts are restricted by default from sending messages with website links, images, email addresses and certain keywords, ensuring free Trials are used by legitimate businesses to test our service.

Review your message to ensure it does not contain the listed elements.

MSG-014 Missing message template Include some text with your image (MMS) message and re-send.  Some carriers require text to be included with your image (it can be as minor as a period). 
MSG-015 Message contains profanity and is blocked  
MSG-016 The number is restricted and cannot be used to send message  
MSG-017 Unable to process message  
MSG-018 Message could not be routed to destination  
MSG-019 Handset unreachable or out of network Delivery of your message failed due to an unavailable or unreachable destination. Common examples are a user who is outside of cellular service or whose mobile device is powered off.
MSG-020 Carrier rejected message as invalid service type.  Usually indicating number is a landline, but occasionally unknown rejection by carrier Delivery of your message failed due to the destination being a landline and incapable of receiving SMS, or an unreachable destination carrier.
MSG-021 Number is a premium rate number and can not accept messages  
MSG-022 Number is a pager and can not accept messages  
MSG-023 Message was rejected by carrier

Your message was rejected by a downstream carrier (e.g. AT&T, Verizon, T-Mobile, etc) for an unknown reason.

  • If the message includes a link, send it without a link to a selection of the same contacts
  • Wait until after the daily carrier reset (11:59PM PST) to attempt the message again to a selection of the same contacts
MSG-024 Message appears to be a duplicate

Sakari has identified your message as a likely duplicate and it has not been sent to the carrier.

Sakari’s duplicate checker prevents the same message from being sent to a contact within a 30 minute period.  Receiving a reply from the contact resets the timer.

MSG-025 Unknown provider error

Sakari sent the message, and the number provider returned an unrecognised error. 

Sakari works continuously to identify and map unknown provider errors to Sakari error codes.

MSG-026 The message timed out

Delivery of your message failed and exceeded the carrier retry time limit. 

Common examples are a user who was out of range, their phone was off or the message was unable to be delivered due to a network outage or other connectivity issue.

MSG-027 Downstream provider failed multiple times; retry limit exceeded  
MSG-028 Message delivery has been throttled; message will be retried shortly  
MSG-029 Phone number has exceeded daily limits on message throughput The rate or quantity of messages has exceeded the daily carrier limits of the outbound number.  Select a different phone number or add a new number to your account.
MSG-030 Message was destined to a prepaid mobile with insufficient funds, an invalid Postpaid number, or subscriber that opted out of SMS  
MSG-031 Destination app error  
MSG-032 Message has been cancelled manually  
MSG-033 Carrier service failure  
MSG-034 Could not download media  
MSG-035 Message delivery receipt expired  
MSG-036 Messaging to/from a toll-free number is blocked  
MSG-037 Destination number is not allocated SMS services on the outbound number are not available to Sakari. If the number uses Hosted Messaging and has been ported to another provider since hosting, it must be re-hosted.
MSG-038 User has opted out of communication  
MSG-039 Subscriber Age Restriction  
MSG-040 Message exceeds maximum cost set by provider  
MSG-041 MMS is not supported for destination country

Image (MMS) messaging is not supported to the destination country of your recipient. MMS messaging is currently only supported in the United States and Canada.

  • Remove the image for the message.
  • Use Sakari Universal MMS to automatically add your image as a clickable link in your message. 
MSG-042 Provider does not support MMS

Image (MMS) messaging is not supported by the provider of your outbound number. 

  • Remove the image for the message.
  • Use Sakari Universal MMS to automatically add your image as a clickable link in your message. 
MSG-043 Free url shorteners are blocked by carriers

The message was blocked because it included a link shortened with a free URL shortener.

Depending on the carrier, some "free" hosting site links may be blocked as well (e.g. linktr.ee)

MSG-044 Unable to send message to a short code Sakari does not support sending SMS to short code numbers.
MSG-045 Too many messages have been sent between two numbers within a short time period  
MSG-046 Outbound number is not usable by Sakari

Your outbound phone number does not support sending SMS from Sakari.  Check for a change to:

  • the number’s status in Senders
  • the number’s ownership (porting)
  • the number’s status in the integrated provider’s platform
MSG-047 Carrier does not support SMS or file type  
MSG-048 Attachment is too large  
MSG-049 Message has expired  
MSG-050 Destination carrier requires sender ID pre-registration  
MSG-057 Sent over daily limit for your 10DLC brand. Please contact help@sakari.io for more information  
MSG-058 Phone number has exceeded daily limits on message throughput. Please submit a toll free verification request  
MSG-061 Messaging on unverified toll free numbers is blocked  
MSG-062 Message contains blocked words

Due to recent updates with regulations and potential carrier fines, certain messages flagged for inappropriate content may be blocked from sending.

If you believe your use-case for sending these messages does not violate any local laws or regulations, please contact our support team at help@sakari.io for further assistance.

NMBR-001 Invalid phone number type  
NMBR-002 Unsupported country for purchasing phone number  
NMBR-003 Outbound number does not support SMS  
NMBR-004 Outbound number is not active  
NOTIF-001 Specify notification types to delete  
PN-001 Phone number does not support destination country  
PN-002 Phone number does not exist  
PN-003 Phone number has been ported to another provider  
PN-004 Can not enable hosted messaging on trial accounts  
PN-005 Can not enable mobile numbers  
PN-006 Phone number is already verified  
PN-007 This type of phone number can not be added to pass through plans  
PN-008 Only numbers from US or Canada can be enabled  
PN-009 Call forwarding is not supported on trial accounts  
PN-010 Currently we do not support the requested country  
PN-011 We do not support self-service issuance of numbers for this country. Please raise a ticket at help@sakari.io  
PN-012 Line type is not supported in this country  
REG-001 Brand is not associated with this account.  Please register with 10DLC.  
REG-002 Outbound messaging to US numbers is prohibited without 10DLC registration.  Please contact your number provider for registration details.

The outbound number is not associated with an approved 10DLC messaging registration.

REG-003 Messaging to US numbers will be prohibited without 10DLC registration from June 1st, 2022. Please contact help@sakari.io to start your submission  
REG-012 Messaging to US numbers is prohibited on unverified toll free numbers. Please contact help@sakari.io to start your submission

The outbound number is not associated with an approved toll-free number registration.

REG-014 Contact must be opted in prior to sending a message while sender is on 10DLC Free Trial

Messaging from the US local area code number provided on Sakari Free Trials is restricted by the US SMS carriers (see Platform Free Trial (US Trial Accounts) FAQ).

Contacts must text START to the provided number before messages will be delivered.

REG-015 A maximum of 10 opted in contacts can be messaged while sender is on 10DLC Free Trial

Messaging from the US local area code number provided on Sakari Free Trials is restricted by the US SMS carriers (see Platform Free Trial (US Trial Accounts) FAQ).

Messages can be sent to a maximum of 10 contacts who have texted START to the provided number.

TEMP-001 Could not find template  
TEMP-002 Invalid template type for rendering web page  
TEMP-003 Invalid template type  
TEMP-004 Invalid template  
TOOLS-001 Messages count must be same as outgoing length  
TOOLS-002 Please supply a valid number  
TOOLS-003 Please supply a valid country code  
TOOLS-004 Maximum of 10 urls to shorten  
TOOLS-005 Unable to upload file  
TOOLS-006 Missing file to upload  
USER-001 Unable to send password reset email  
USER-002 Can not remove yourself from this account

You are logged in to Sakari using the login profile you are attempting to delete.

To change the email for your login profile, please review How do I change the email on a user log-in profile?

USER-003 User does not have access to this account  

 

Was this article helpful?

16 out of 61 found this helpful

Have more questions? Submit a request