Ytel API Fundamentals

Enable voice, text, email, and direct mail features within any application.

Ytel API is a communications API built around REST principles. If you are familiar with other REST APIs, you should not have any problems getting started with the Ytel API.

To gain a better understanding for the API’s structure and its capabilities, it is best to conceptualize the API in terms of Channels. A Channel is a communication group each with its own set of resources. Ytel API is organized into four communication Channels of Voice, Text, Email, and Direct Mail.

API Organization

As previously stated, Ytel API is structured into four communication channels. The API contains approximately 80 endpoints (resources) organized into the four communication channels. Throughout this API reference, resource documentation is grouped into resource families. There are currently 15 resource families.

The following diagram shows how the Ytel API is structured.

Current API Version

New features and improvements to the Ytel API are occurring continuously. In order to stay up to date with these changes, please make plans to upgrade all API calls to the latest version.

Effective April 1st, 2017, the Ytel API was upgraded to support v3. v2 of the API will continue to be supported in the meantime. However, be aware that v2 will be marked as deprecated in the near future and only v3 will be supported. We will make announcements about these changes.

Current Version

Version v3 is the latest version of the API.

All URI references to the API should be structured as:

    https://api.message360.com/api/v3/{M360_Family}/{Resource}.{json|xml}
  

Ytel API Accounts

Upon successfully signing up for a Ytel API account, an AccountSid and an AuthToken will be assigned to the account. The AccountSid and AuthToken are used in tandem and function together as the account credentials against the API and other Ytel API features.

Throughout this documentation, the AccountSid and AuthToken will be represented as {AccountSid} and {AuthToken} in code snippets and response objects.

These credentials can be found in the Ytel API Dashboard as well as the Welcome to Ytel API email that was sent after successfully registering an account.

Ytel API Subaccounts

The Ytel API has support for Subaccounts. Simply put, a Subaccount is a Ytel API account created and managed "owned" by another account, a parent account referred to as the Master Account. A single Master Account can create and manage multiple Subaccounts.

Fundamentally, a Subaccount is no different than its Master Account. However, there are a few key differences between a Master Account and Subaccount functionality. The following table provides a comparison between the two:

Master AccountSubaccount
Can create another account (ie Subaccount) CANNOT create any account
Handles account balance and fund management CANNOT add any funds
Full API access Full API access with funds deducted by Master account
Has access to subaccount info and usage statistics Has access to ONLY its info and usage statistics
Has its own AccountSid and AuthToken Also has its own AccountSid and AuthToken

After creating a Subaccount, Ytel API will send a confirmation email to the email address provided during Subaccount creation. The newly-created Subaccount will require the setting of a password in order to login and authenticate as a valid user. Once the account is activated and a password is set, the customer can login to the Dashboard and use the Ytel API with the limitations in place defined in the table above.

All billing and funds management regarding a Subaccount is handled by its Master Account. This means that chargeable usage features such as purchasing phone numbers, making phone calls, sending emails, sending/receiving SMS messages, and so forth will handled entirely by the Master account. Pricing for these features is the same for a Subaccount as it is for the Master account. For a pricing list, refer to Ytel API Pricing.

Features

The Ytel API Subaccounts feature is designed for a single customer to create multiple child accounts that each contain their own phone numbers and usage statistics. The implementation of this feature can be used in two ways: by using the Dashboard UI or by using the API. The Subaccounts feature currently supports the following abilities:

  • creating a Subaccount
  • suspending/activating a Subaccount
  • deleting a Subaccount

Subaccount management can be done in the Ytel API Dashboard.

To manage Subaccounts with the API, refer to the Subaccounts API Documentation.

Authentication

All requests sent to Ytel API must be authenticated over HTTPS.

The security method used is basic authentication with Base64 encoding. Each request will require the setting of the Authorization header with the encoded credentials. The credentials are the combination of {AccountSid}:{AuthToken}.

Both the AccountSid and AuthToken are Universally Unique Identifiers (UUID). These credential values can be found in the Ytel API Dashboard.

The following request demonstrates how to authenticate by setting a header with cURL:


  curl -X POST 'https://api.message360.com/api/v3/...' -u '{AccountSid}:{AuthToken}'
  

Instead of using cURL, several libraries have been created for Ytel API that aid in using the API. These libraries have been created in the most common languages. Browse Libraries & Downloads to see which libraries are available and suitable for your needs.

The following request demonstrates how to authenticate using the Ytel API PHP library:


//Load the PHP library
require_once '../vendor/autoload.php';

//initialize the library with credentials
$basicAuthUserName = '{AccountSid}'; //username is the AccountSid
$basicAuthPassword = '{AuthToken}';  //password is the AuthToken

$client = new Message360 Client($basicAuthUserName, $basicAuthPassword);

//set API call parameter values, such as
$params['date'] = '{datavalue}';

$account = $client->getAccount();
$result = $account->createViewAccount($params);
  

HTTP Methods

The API supports the following HTTP methods (verbs). The table below maps the HTTP methods to their logical meanings.

HTTP Method (Verb)Meaning
POST
read, view, list
POST
add, update, send, buy
POST
remove, delete

Throughout the API, you will notice the resources are often referred to the meanings listed in the above table.

Response Object

Ytel API supports both JSON and XML formats. The API will return a status of 200 for every request. Any errors returned will be set in the response object. Each response object will contain a Ytel API key followed by a Response Status Code. The Response Status Code denotes success or failure of the response. The Response Status Code is either a 0 or a 1 for representing error and success, respectively.

For API GET requests that return a single object, the response object will contain the name of the object returned and data associated with it.

For instance, to retrieve a SMS message by its MessageSid, the response object returned would be:


{
  "Message360": {
    "ResponseStatus": 1,
    "Message": {
      "ApiVersion": "2",
      "MessageSid": "{MessageSid}",
      "From": "XXXYYYZZZZ",
      "To": "XXXYYYZZZ",
      "Body": "This is my awesome SMS message.",
      "MessagePrice": "$X.XXXX",
      "DateSent": "2016-05-18 17:25:25",
      "Status": "success"
    }
  }
}
  

For API GET requests that return a list of objects, the Count, Page, and PageSize values will be returned in the response object for paging the results.

For instance, to retrieve a list of SMS messages, the response object returned would be:


{
  "Message360": {
    "ResponseStatus": 1,
    "MessageCount": 10,
    "Page": 1,
    "PageSize": 10,
    "Messages": {
      "Message": [
        {
          "ApiVersion": "3",
          "MessageSid": "{MessageSid}",
          "From": "+XXXYYYZZZZ",
          "To": "+XXXYYYZZZZ",
          "Body": "My awesome SMS message",
          "Date": "2016-06-08 17:31:01",
          "MessagePrice": "$X.XXXX",
          "Status": "success"
        },
        . . .
    ]
  }
}
  

For response objects returned when the Response Status code is 0, there will be an added Errors key to list one or more error messages resulting from the call. For instance, if no recordings are found on your Ytel API account, the following response object would be returned:


{
  "Message360": {
    "ResponseStatus": 0,
    "Errors": {
      "Error": [
        {
          "Code": "ER-M360-REC-1606",
          "Message": "No Data Found.",
          "MoreInfo": []
        }
      ]
    }
  }
}
  

The above Response Object structure is consistently used across all Ytel API Channels. The response object for retrieving a list of voice calls will contain a “calls” object containing a list of call objects. The response object for retrieving a list of purchased phone numbers will contain a “phones” object containing a list of phone objects.

Error Codes

About Ytel API Error Codes

Error codes are divided into groups based on the family of resources for which they belong. Each table contains the Code and its corresponding Error Message.

Each error code is formatted as ER-M360-{resource family}-{digit}.

Account Error Codes

The following is a list of error codes associated with the accounts family of resources.

Code Error Message
ER-M360-ACC-1500 Your Account Sid or Auth Token is incorrect.

Address Error Codes

The following is a list of error codes associated with the addresses family of resources.

Code Error Message
ER-M360-ADDRESS-701 Address ID not provided.
ER-M360-ADDRESS-702 Name required.
ER-M360-ADDRESS-703 Address required.
ER-M360-ADDRESS-704 Country required.
ER-M360-ADDRESS-705 State required.
ER-M360-ADDRESS-706 City required.
ER-M360-ADDRESS-707 Zip required.
ER-M360-ADDRESS-708 The address must be between 2-200 characters in length.
ER-M360-ADDRESS-709 Please enter a valid email.
ER-M360-ADDRESS-710 Oops! The record already exists.
ER-M360-ADDRESS-711 Oops! Some error occurred. Address ID provided does not exist.
ER-M360-ADDRESS-712 Oops! An error occurred. The Address ID provided either does not exist or does not belong to your account.
ER-M360-ADDRESS-713 No Data found related to your search.
ER-M360-ADDRESS-714 Oops! A database error occurred. The address can't be deleted right now.
ER-M360-ADDRESS-715 Country is missing in the provided address.
ER-M360-ADDRESS-716 is an invalid input parameter.$_COOKIE
ER-M360-ADDRESS-717 Invalid value passed for 'page'. Page Number can not be negative or alphanumeric. Page Number can only have a positive integer value.
ER-M360-ADDRESS-718 Invalid value passed for 'pagesize'. Page Size can not be negative or alphanumeric. Page Size can only have a positive integer value.

Area Mail Error Codes

The following is a list of error codes associated with the areamail family of resources.

Code Error Message
ER-M360-AREAMAIL-1301 Routes required.
ER-M360-AREAMAIL-1302 The description must be between 2-50 characters in length.
ER-M360-AREAMAIL-1303 Please select either attachbyid or attachement files (front, back), choose one.
ER-M360-AREAMAIL-1304 Invalid attachment ID.
ER-M360-AREAMAIL-1305 targettype required (either 'all' or 'residential', choose one).
ER-M360-AREAMAIL-1306 Invalid AreaMail ID Attachment.
ER-M360-AREAMAIL-1307 Current range for area mails is between 500 - 2499. Your selected count of areamails is
ER-M360-AREAMAIL-1308 There are insufficient balance to process this request. Please add funds to your account to complete this Area Mail request.
ER-M360-AREAMAIL-1309 AreaMail has not been created.
ER-M360-AREAMAIL-1310 AreaMail ID not provided.
ER-M360-AREAMAIL-1311 Oops! The AreaMail ID provided either does not exist or does not belong to your account.
ER-M360-AREAMAIL-1312 No Data found related to your search.
ER-M360-AREAMAIL-1313 Invalid value passed for 'page'. Page Number can not be negative or alphanumeric. Page Number can only have a positive integer value.
ER-M360-AREAMAIL-1314 Invalid value passed for 'pagesize'. Page Size can not be negative or alphanumeric. Page Size can only have a positive integer value.
ER-M360-AREAMAIL-1315 is an invalid input parameter.
ER-M360-AREAMAIL-1316 No front image/ file/ URL/ HTML is available for this Area Mail request.
ER-M360-AREAMAIL-1317 No back image/ file/ URL/ HTML is available for this AreaMail.

Area Mail Error Codes

The following is a list of error codes associated with the carrier family of resources.

Code Error Message
ER-M360-Carrier-1601 There are insufficient funds available to process this request.
ER-M360-Carrier-1602 Please enter Phone Number.
ER-M360-Carrier-1603 Please enter numeric Phone Number.
ER-M360-Carrier-1604 Please enter numeric 'page' parameter.
ER-M360-Carrier-1605 Please enter numeric 'pagesize' parameter.
ER-M360-Carrier-1606 No data found.
ER-M360-Carrier-1607 Please enter a valid 10 digit phone number.

Calls Error Codes

The following is a list of error codes associated with the calls family of resources.

Code Error Message
ER-M360-CL-201 No Call found.
ER-M360-CL-202 Please enter CallSid.
ER-M360-CL-203 Please enter numeric 'page' parameter.
ER-M360-CL-204 Please enter numeric 'pagesize' parameter.
ER-M360-CL-205 Please enter numeric 'From' Number.
ER-M360-CL-206 Please enter numeric 'To' Number.
ER-M360-CL-207 Audio URL is required.
ER-M360-CL-208 The audio URL is in an invalid format.
ER-M360-CL-209 Length parameter should be Integer value.
ER-M360-CL-210 This is not a live Call Sid able to make this request.
ER-M360-CL-211 Recording is already in progress.
ER-M360-CL-212 Value for Tempo must be greater than 0.
ER-M360-CL-213 Value for Rate must be greater than 0.
ER-M360-CL-214 Value for Pitch must be greater than 0.
ER-M360-CL-215 Value for PitchOctaves must be between -1 and 1.
ER-M360-CL-216 Value for PitchSemiTones must be between -14 and 14.
ER-M360-CL-217 Please enter 'From' Number.
ER-M360-CL-218 Enter the numeric 'From' number.
ER-M360-CL-219 Please enter a valid 10 digit phone number.
ER-M360-CL-220 Please enter 'To' Number.
ER-M360-CL-221 Enter the numeric 'To' number.
ER-M360-CL-222 Please enter a valid 10 digit 'To' Number.
ER-M360-CL-223 Your account does not have sufficient credit to process this call.
ER-M360-CL-224 Please enter 'From' Country code.
ER-M360-CL-225 Please enter 'To' Country code.
ER-M360-CL-226 Please enter numeric 'From' Country code.
ER-M360-CL-227 Please enter the numeric 'To' country code.
ER-M360-CL-228 Please enter URL of 'URI'.
ER-M360-CL-229 Please enter URL of 'URI' with valid format.
ER-M360-CL-230 Please enter 'statuscallback' URL then enter.
ER-M360-CL-231 Please enter 'statuscallback' URL with valid format.
ER-M360-CL-232 Please enter 'fallbackurl' URL then enter 'fallbackmethod'.
ER-M360-CL-233 Please enter 'fallbackurl' URL with valid format.
ER-M360-CL-234 Please enter 'heartbeaturl' URL then enter 'heartbeatmethod'.
ER-M360-CL-235 Please enter 'HeartbeatUrl' URL with valid format.
ER-M360-CL-236 Please set 'Record' to True then select 'RecordCallback' URL.
ER-M360-CL-237 Please enter 'RecordCallback' URL with valid format.
ER-M360-CL-238 Please set 'Transcribe' to True then select 'TranscribeCallback' URL.
ER-M360-CL-239 Please enter 'TranscribeCallbackUrl' URL with valid format.
ER-M360-CL-240 Please enter 'Timeout' between 0 to 999 sec.
ER-M360-CL-241 Please enter 'ifmachineurl' URL then enter 'ifmachinemethod'.
ER-M360-CL-242 Please enter 'IfMachineUrl' URL with valid format.
ER-M360-CL-243 Please select 'Method' with valid format.
ER-M360-CL-244 Please select 'statuscallbackmethod' with valid format.
ER-M360-CL-245 Please select 'fallbackmethod' with valid format.
ER-M360-CL-246 Please select 'heartbeatmethod' with valid format.
ER-M360-CL-247 Please select 'ForwardedFrom' with valid format.
ER-M360-CL-248 Please select 'HideCallerId' with valid format.
ER-M360-CL-249 Please select 'Transcribe' with valid format.
ER-M360-CL-250 Please select 'Record' with valid format.
ER-M360-CL-251 Please select 'StraightToVoicemail' with valid format.
ER-M360-CL-252 Please select 'IfMachineMethod' with valid format.
ER-M360-CL-253 Oops! An error occurred. The call is unable to connect to the server. Please try again later or contact support@ytel.com.
ER-M360-CL-256 Please select 'True' to start Recordings.

Conference Error Codes

The following is a list of error codes associated with the conference family of resources.

Code Error Message
ER-M360-CON-1700 Your Account ID is blank.
ER-M360-CON-1701 Participant Sid is required.
ER-M360-CON-1702 Conference Sid is required.
ER-M360-CON-1703 AudioURL is Not Valid.
ER-M360-CON-1704 Participant Sid is required.
ER-M360-CON-1705 Please enter 'From' Number.
ER-M360-CON-1706 Please enter numeric 'From' Number.
ER-M360-CON-1707 Please enter valid 10 digit 'From' Number.
ER-M360-CON-1708 Please enter 'To' Number
ER-M360-CON-1709 Please enter numeric 'To' Number
ER-M360-CON-1710 Please enter valid 10 digit 'To' Number.
ER-M360-CON-1711 Please enter 'From' Country code.
ER-M360-CON-1712 Please enter 'To' Country code.
ER-M360-CON-1713 Please enter numeric 'From' Country code.
ER-M360-CON-1714 Please enter numeric 'To' Country code.
ER-M360-CON-1715 Please use verified number.
ER-M360-CON-1716 Please enter participant Number.
ER-M360-CON-1717 Please enter numeric participant Number.
ER-M360-CON-1718 Please enter valid 10 digit participant Number.
ER-M360-CON-1719 Please enter participant Country code.
ER-M360-CON-1720 Please enter numeric participant Country code.
ER-M360-CON-1721 Schedule time must be greater than current time.
ER-M360-CON-1722 'From' number not found.
ER-M360-CON-1723 Please verify ToCountryCode.
ER-M360-CON-1724 Cannot connect to redis server.
ER-M360-CON-1725 Conference room is full.
ER-M360-CON-1726 ConferenceSid is Wrong.
ER-M360-CON-1727 No Conference found.
ER-M360-CON-1728 Participant Not Found.
ER-M360-CON-1729 ServerId is required.

Email Error Codes

The following is a list of error codes associated with the email family of resources.

Code Error Message
ER-M360-EMAIL-600 Please enter 'To' Email Address.
ER-M360-EMAIL-601 Please enter a subject.
ER-M360-EMAIL-602 Please enter a message.
ER-M360-EMAIL-603 Please enter 'To' Email Address in a valid format.
ER-M360-EMAIL-604 Please enter CC Email Addresses in valid format.
ER-M360-EMAIL-605 Please enter BCC Email addresses in a valid format.
ER-M360-EMAIL-606 Please enter 'From' Email Address in valid format.
ER-M360-EMAIL-607 Attachment size must be less than or equal to 2 MB.
ER-M360-EMAIL-608 Attachment extensions are not permitted.
ER-M360-EMAIL-609 SMTP not Configured.Please configure SMTP then send mail.
ER-M360-EMAIL-610 The email is not verified. Please verify email from your mail ID.
ER-M360-EMAIL-611 The email was not sent due to insufficient balance. Please add funds to complete this request.
ER-M360-EMAIL-612 The SubUser does not exist.
ER-M360-EMAIL-613 The email did not send due to insufficient balance. Please add funds to complete this request.
ER-M360-EMAIL-614 SMTP not Configured. Please configure SMTP.
ER-M360-EMAIL-615 Please enter the numeric limit value.
ER-M360-EMAIL-616 Please enter the numeric offset value.
ER-M360-EMAIL-617 No record found.
ER-M360-EMAIL-618 Please enter the email address.
ER-M360-EMAIL-619 Please enter a valid email address.

Letters Error Codes

The following is a list of error codes associated with the letters family of resources.

Code Error Message
ER-M360-LETTER-1001 Letter ID not provided.
ER-M360-LETTER-1002 'To' address required.
ER-M360-LETTER-1003 'From' address required.
ER-M360-LETTER-1004 Please either select attachment by id or upload a file for letter template or provide a direct url or html. Provide only one of them.
ER-M360-LETTER-1005 The attachment ID used does not exist.
ER-M360-LETTER-1006 The attached PDF can have maximum 4 pages in it but in currently attached PDF number of pages are
ER-M360-LETTER-1007 Invalid color
ER-M360-LETTER-1008 Invalid doublesided
ER-M360-LETTER-1009 Invalid extraservice
ER-M360-LETTER-1010 Description must be between 2 to 50 characters in length.
ER-M360-LETTER-1011 Insufficient balance. Please add funds to create a letter.
ER-M360-LETTER-1013 Letter has not been created.
ER-M360-LETTER-1017 Oops! The letter ID provided either does not exist or does not belong to your account.
ER-M360-LETTER-1018 No data was found related to your search.
ER-M360-LETTER-1019 No file is available for this letter.
ER-M360-LETTER-1020 is an invalid input parameter
ER-M360-LETTER-1021 Invalid value passed for 'page'. Page Number can not be negative or alphanumeric. Page Number can only have a positive integer value.
ER-M360-LETTER-1022 Invalid value passed for 'pagesize'. Page Size can not be negative or alphanumeric. Page Size can only have a positive integer value.

Phone Number Error Codes

The following is a list of error codes associated with the incomingphone family of resources.

Code Error Message
ER-M360-PHONE-801 Number Type should be Voice, SMS, or All.
ER-M360-PHONE-802 Area Code contains only numbers.
ER-M360-PHONE-803 Region Code contains only letters.
ER-M360-PHONE-804 Pagesize contains only numbers.
ER-M360-PHONE-805 No Phone Numbers Found.
ER-M360-PHONE-806 Page contains only numbers.
ER-M360-PHONE-807 Please enter phone number.
ER-M360-PHONE-808 Please enter the URL in a valid format.
ER-M360-PHONE-809 The Company ID was not set. Please contact support@ytel.com.
ER-M360-PHONE-810 Invalid Area code.

Postcard Error Codes

The following is a list of error codes associated with the postcards family of resources.

Code Error Message
ER-M360-POSTCARD-901 Postcard ID not provided.
ER-M360-POSTCARD-902 'To' Address required.
ER-M360-POSTCARD-903 'From' addresses required.
ER-M360-POSTCARD-904 Please select the attachment by ID, attach front or back files, or provide a message for your postcard. Please provide only one of these.
ER-M360-POSTCARD-905 The attachment ID used does not exist.
ER-M360-POSTCARD-906 File length/width is incorrect size. Expected dimensions are: 6.25 in x 11.25 in. The provided file has dimensions of: 4.25 in x 6.25 in.
ER-M360-POSTCARD-907 File length/width is incorrect size. Expected dimensions are: 4.25 in x 6.25 in. The provided file has dimensions of: 6.25 in x 11.25 in.
ER-M360-POSTCARD-908 Invalid attachment ID and setting size.
ER-M360-POSTCARD-909 Setting ID required.
ER-M360-POSTCARD-910 Message must be less than or equal to 350 characters in length.
ER-M360-POSTCARD-911 Insufficient balance. Please add funds to create a postcard.
ER-M360-POSTCARD-912 Invalid Postcard ID attachment.
ER-M360-POSTCARD-913 Postcard has not been created.
ER-M360-POSTCARD-914 Please either attach a back image, provide a URL to a back image, provide HTML, or provide a message. Please provide only one of these.
ER-M360-POSTCARD-915 Please Attach Front File.
ER-M360-POSTCARD-916 Please either attach a back image or provide a message.
ER-M360-POSTCARD-917 Oops! The Postcard ID provided does not exist or does not belong to your account.
ER-M360-POSTCARD-918 No Data found related to your search.
ER-M360-POSTCARD-919 No front image/ file/ URL/ or HTML is available for this postcard.
ER-M360-POSTCARD-920 No back image/ file/ URL/ HTML is available for this postcard.
ER-M360-POSTCARD-921 is an invalid input parameter.
ER-M360-POSTCARD-922 Invalid value passed for 'page'. Page Number can not be negative or alphanumeric. Page Number can only have a positive integer value.
ER-M360-POSTCARD-923 Invalid value passed for 'pagesize'. Page Size can not be negative or alphanumeric. Page Size can only have a positive integer value.

Recordings Error Codes

The following is a list of error codes associated with the recordings family of resources.

Code Error Message
ER-M360-REC-1600 Your Account ID is incorrect.
ER-M360-REC-1601 Your Request not found
ER-M360-REC-1602 Your Request was already deleted or can not be found.
ER-M360-REC-1603 Record ID can not be blank.
ER-M360-REC-1604 Record ID can not be blank.
ER-M360-REC-1605 Your Auth Token is incorrect.
ER-M360-REC-1606 No Data Found

Text/SMS Error Codes

The following is a list of error codes associated with the SMS family of resources.

Code Error Message
ER-M360-SMS-201 Please enter 'From' Number.
ER-M360-SMS-202 Please enter a numeric 'From' Number.
ER-M360-SMS-203 Please enter a valid 10 digit 'From' Number.
ER-M360-SMS-204 Please enter 'To' Number.
ER-M360-SMS-205 Please enter a numeric 'To' Number.
ER-M360-SMS-206 Please enter a valid 10 digit 'To' Number.
ER-M360-SMS-207 Please use a verified number.
ER-M360-SMS-208 Your account does not have sufficient credit to process this message.
ER-M360-SMS-209 Please enter valid Message Status Callback URL.
ER-M360-SMS-210 Please enter Message Sid.
ER-M360-SMS-211 Please enter numeric 'page' parameters.
ER-M360-SMS-212 Please enter numeric 'pagesize' parameters.
ER-M360-SMS-213 No Message found.
ER-M360-SMS-214 Please enter 'From' Country code.
ER-M360-SMS-215 Please enter 'To' Country code.
ER-M360-SMS-216 Please enter numeric 'From' Country code.
ER-M360-SMS-217 Please enter numeric 'To' Country code.
ER-M360-SMS-218 Please enter only GET or POST for method values.
ER-M360-SMS-219 Message Sid is required.
ER-M360-SMS-220 Please enter 'To' number.
ER-M360-SMS-221 Please enter 'From' Number.
ER-M360-SMS-222 Please enter 'expires' parameter.
ER-M360-SMS-223 Please enter 'authorizedby' parameter.
ER-M360-SMS-224 Please enter 'authorizedhow' parameters.
ER-M360-SMS-225 Insufficient fund to process this request.
ER-M360-SMS-226 Please enter 'From' Country code.
ER-M360-SMS-227 Please enter 'To' Country code
ER-M360-SMS-228 Please enter valid values for expires parameter (0 or 1)

Transcriptions Error Codes

The following is a list of error codes associated with the transcriptions family of resources.

Code Error Message
ER-M360-TRANSCRIBE-1701 Transcription Sid is required.
ER-M360-TRANSCRIBE-1702 Incorrect Account Sid or Authentication Token Provided
ER-M360-TRANSCRIBE-1703 No record found.
ER-M360-TRANSCRIBE-1704 AudioURL is required.
ER-M360-TRANSCRIBE-1705 Recording Sid is required.
ER-M360-TRANSCRIBE-1706 Only MP3 or .wav file formats permitted.
ER-M360-TRANSCRIBE-1707 A valid AudioURL is required.
ER-M360-TRANSCRIBE-1708 This account has not set its Company ID. Please contact support@ytel.com.
ER-M360-TRANSCRIBE-1709 RecordingURL was not found.
ER-M360-TRANSCRIBE-1710 You have already transcribed on this recordingSid
ER-M360-TRANSCRIBE-1711 Failed to load audio URL. Please try again.