Authy Return and Error Codes

As a RESTful API, Twilio's Authy API will return HTTP responses and error codes which will help verify normal behavior as well as contextualize exceptions.

Return Codes

The following status codes are used:

200: OK Response is correct. The body of the response will include the data requested.

400: Bad Request There was an error with the request. The body of the response will have more info.

401: Unauthorized Token is invalid. If your API key is wrong a 401 will be generated. Please check the API key.

429: Too Many Requests API usage limit. If you reach API usage limits, a 429 will be returned. Please wait until you pass the limit and attempt the call again.

503: Service Unavailable There are multiple possible reasons for a HTTP 503 error.

  • Internal Twilio error.
  • Your application is accessing an API call you don't have access to.

Error Codes

When the API returns a status other than 200, we add an error code in the message body. This table enumerates and describes all of the possible error codes.

Error Code HTTP Status Error Message Description Category
60000 400 An error occurred Default error message when an error is not configured correctly. ALL
60001 401 Invalid API key When the given API key does not correspond to any Authy app ALL
60002 400 Invalid request A request containing invalid parameters or invalid data ALL
60003 429 DoS protection Client has reached the maximum number of requests per time unit on the given endpoint ALL
60004 400 Invalid parameter The given parameter is not valid ALL
60005 400 UTF-8 invalid Client sending request with UTF-8 invalid characters ALL
60006 503 Phone calls are not enabled on this account The application has not enabled phone calls (they can do that from the dashboard) TOTP
60007 503 SMS is not enabled The application has disabled sms (they can do that from the dashboard) TOTP
60008 403 Your account is suspended The account has been suspended on Twilio side or for internal reason TOTP
60009 429 Monthly SMS limit reached Application has reached monthly sms limit TOTP
60010 429 Daily SMS limit reached Application has reached daily sms limit TOTP
60011 429 Monthly Phone Calls limit reached Application has reached monthly phone calls limit TOTP
60012 429 Daily Phone Calls limit reached Application has reached daily phone calls limit TOTP
60013 503 Country code is banned Request cannot be completed because the country code is banned TOTP
60014 503 Call was not started An error occurred while making the phone call TOTP
60015 503 SMS token was not sent The sms TOTP could not be sent, internal error TOTP
60016 401 User doesn't exist The given user id does not correspond to any user TOTP
60017 503 User suspended The action cannot be completed because the user has been suspended TOTP
60018 503 User disabled The action cannot be completed because the user's device has been suspended TOTP
60019 401 Token reused The token given was used previously, it does not work twice TOTP
60020 401 Token invalid The token given was not valid TOTP
60021 403 Phone verification couldn't be created An error occurring creating phone verification Phone Verification
60022 401 Verification code is incorrect The phone verification code was incorrect Phone Verification
60023 404 Phone verification not found The phone verification was not found with the parameters given Phone Verification
60024 403 Couldn't get phone information Fetching phone info failed Phone Intelligence
60025 503 Server error while querying phone information. Please try again later Internal error while querying phone info. Phone Intelligence
60026 404 User doesn't exist The given user id does not correspond to any user Users
60027 400 User was not valid The user is invalid, it cannot be stored Users
60028 403 The user cannot be deleted There was an error deleting the user Users
60029 403 Activity couldn't be created There was an error creating the activity for the user Users
60030 400 You are not passing the user params correctly User parameters are incorrect Users
60031 403 Action not authorized Customer has not authorization to complete the action Users
60032 400 SMS was not found Used by the Feedback API, when a record cannot be found with the given SMS id Feedback
60033 400 Phone number is invalid The phone number or country code is invalid ALL
60034 400 Invalid registration request There was an error creating the registration request Registration
60035 404 Registration request not found The registration request was not found with the parameters given Registration
60036 401 Invalid registration PIN The registration PIN received is incorrect Registration
60037 403 Registration request expired The registration request expire after 1 hour Registration
60038 403 Email is invalid User entered an invalid email TOTP
60042 400 Either uuid or country_code and phone number are required Invalid parameters in phone verification Phone Verification
60046 400 Missing dashboard account ids to process accounts ids required to be processed Dashboard
60047 403 Invalid API key. Confirm your API key by going to https://dashboard.authy.com When request come with twilio api key rather than authy api key TOTP
60049 404 Onetouch Approval request not found Onetouch Approval request not found Onetouch
60050 404 Onetouch Unregistered user Application has not added user Onetouch
60051 404 Onetouch device not found User does not have onetouch device for given application Onetouch
60052 400 An error ocurred sending the approval request. Internal connection error Communication error with onetouch service Onetouch
60053 400 An error ocurred sending the approval request When can not create an approval request Onetouch
60054 400 An error ocurred on approval request When approval request is not pending and receive an approve request Onetouch
60055 400 An error ocurred notifying customer When onetouch approval request could not be notified to user Onetouch
60056 505 You must use https protocol to use this api All requests in production should be through https TOTP
60057 503 Your account has been suspended temporarily This is responded when user exceed rate limits usage TOTP
60058 404 Phone number not found Phone number not found TOTP
60059 404 Phone number is invalid When phone number is not valid TOTP
60060 503 Your account is suspended Twilio account is suspended Phone Verification
60061 503 Your application is suspended Your application is suspended TOTP
60063 403 Disallowed ip address Ip is banned to use public endpoints TOTP
60064 403 Failed to enable OneTouch Can't update application settings on enabling onetouch Dashboard
60065 403 Needs to enable OneTouch first Application does not have onetouch enabled and is trying to do a onetouch request Dashboard
60066 403 Error saving the callback information When application settings can't be updated with callback information Dashboard
60067 403 Access blocked for user with multidevices When user wants to make a changes phone and doesn't have multiple device enabled will raise this error TOTP
60068 401 Can not update device in registration In device registration device was invalid could not save changes in device Registration
60069 400 Access key can not be saved Access key invalid on creation Dashboard
60070 400 Application was not valid Application was not valid on create or update Dashboard
60071 404 Access key not found Access key not found Dashboard
60072 404 Invalid access key The access key is wrong Dashboard
60073 400 Invalid application API key Application API Key is wrong Dashboard
60074 400 Access key doesn't have enough permissions The given access key doesn't have enough permissions to access the url Dashboard
60075 400 Delete application failed Can not delete application due some special condition. i.e still has users when tried to delete the app or has pending invoices Dashboard
60078 403 Invalid country code The given country code is not valid ALL
60079 400 Approval request is not pending Cannot execute the action because approval request is not pending Onetouch
60080 400 Approval request is invalid Approval request cannot be saved, it's invalid Onetouch
60082 403 Can not send SMS to landline phone numbers When trying to send a SMS to a landline phone number Phone Verification
60083 403 Phone number not provisioned with any carrier When trying to send a phone verification to a not provisioned phone number Phone Verification
60085 403 Cannot execute action because OneTouch is not enabled OneTouch should be enabled in the Authy Dashboard before executing the action OneTouch

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the Twilio tag on Stack Overflow.