Sidebar Menu

General

Where can I download the SMS Notify! API?

SMS Notify! is not available for download. A developer/programmer is necessary to write the code that communicates with our API.

How do I know if a message was delivered to the recipient’s mobile device?

Messages sent with a long code need confirmation from the recipient. For messages sent with a short code, delivery receipts (if provided by the recipient’s carrier) can be seen on a postback URL.

What carriers do you support?

All major U.S. and Canadian carriers are supported when sending from U.S. long codes. Global long codes are available with International Extended SMS.

Is there a character limit for SMS messages?

Yes. If your message is longer than the limits shown below, the API will split it into multiple messages that are equal to or shorter than the specified limits.

Unicode Enabled Concatenation SMS Character Limit (including spaces)
No No 160
Yes No 70
No Yes 153
Yes Yes 67

Can I set up an auto response?

Yes. Use a postback URL.

Are special characters or emojis supported?

Yes. When using the SendMessage method, set the IsUnicode parameter to true.

Are picture or video messages supported?

Yes. When using the SendMessage method, specify the desired files with the Attachments parameter.

Is Unicode supported?

Yes. When using the SendMessage method, set the IsUnicode parameter to true.

Can I send messages to multiple recipients?

Yes. When using the SendMessage method, the To parameter accepts multiple recipient phone numbers.

Can I send SMS messages to an email address?

The API itself does not provide a method to send SMS messages to email. However, you can create additional programming code in your system to forward any SMS messages to a desired email address.

Do you have code examples of API requests?

Yes. Examples of all methods in various programming languages can be viewed by selecting a method from the sidebar.

Do international numbers support two-way messaging?

One-way or two-way messaging support is dependent upon the country of the recipient. Please contact us for further information.

Can I use my current number with your API?

To use your current number with our SMS Notify! API, you need to port the number to CDYNE. Please contact us for assistance.

What is a postback URL?

A postback URL is a live URL that you host that contains code to capture and save any desired information that CDYNE’s system will post/pass along to the URL when a message is sent. This information is only visible to you.

Do you offer vanity short codes or long codes?

Yes. Please contact us for additional information.

Do you offer toll-free SMS numbers?

Yes.

What happens if someone calls the number they received an SMS from?

The caller will hear the following message: If you have received an unwanted or unsolicited message from this number please text back with the word STOP, spelled S T O P, and this provider will be blocked from sending you further messages. You will receive a final text message as a confirmation from this number to verify that you entered in STOP correctly. If you have entered STOP in error and wish to receive more messages from this provider please text back with the word RESUME. This number is currently only used for text messages. Thank you.

Can I change the message a person hears when they call my SMS long code?

You can only change the message a recipient hears when they call your SMS Notify! long code if you use our Phone Notify! API as well. You also need to have a customized incoming call script.

Will SMS Notify! tell me if the recipient’s number is landline or wireless?

No. However, you can use our Phone Verify API to check whether the recipient number is landline or wireless.

Do you offer after-hours support?

Yes, we offer 24/7 technical support. Note that support after business hours (9AM-6PM ET) is meant for technical emergencies only.

Are recipients required to opt in to our messaging campaign before we send them messages?

Yes. FCC/CTIA guidelines require that recipients must opt in (agree) prior to receiving notifications from your company. This is to help prevent spam and unwanted messaging.

Is there a way to prevent incoming messaging?

No. FCC/CTIA guidelines require that all recipients must have a way to opt out of messaging campaigns. Recipients have the option to send in an opt-out keyword (STOP, END, CANCEL, UNSUBSCRIBE, QUIT) at any time.

A recipient opted out. How do they begin receiving messages again?

The recipient can text RESUME to the same long code or short code that the opt-out keyword was sent to.

Is the API HIPPA-compliant?

CDYNE maintains strict security policies that make our facilities HIPPA-compliant, but due to the design of SMS, SMS messages are not HIPPA-compliant.

Can you help me implement the API?

Yes. Contact our support team for help with any questions you have during your testing, implementation, and setup process.

Technical

How do I view incoming messages?

You can use the ReadIncomingMessages method of the API, use a postback URL, or if you have a live account you can view incoming (and outgoing) messages with your reports on your CDYNE Client Portal.

Can I change the Sender ID the recipient sees when a message is received?

You cannot change the Sender ID or number the recipient sees when receiving a message. Recipients will receive messages from the long code(s) or short code assigned to your license key.

Why does the CDYNE response show as QUEUED and not SENT after I send a message?

Immediately after submitting a request to CDYNE, the initial response will show the message as QUEUED, as our system just received the request. The message will be sent out shortly or at the time you specified within your request. At that time, the response will automatically change to SENT.

Where can I view a list of error codes/response codes?

All possible error/response codes can be viewed on our wiki.

Does an international recipient’s number need to be in a certain format?

Yes. To send to recipients outside of the U.S. or Canada, you need to place 011 prior to the country code within the phone number.

Is HTTPS or encryption supported with your API?

Yes.

What are the IP ranges we need to allow communication to/from?

4.59.146.64-128 and 4.26.64.64-128

How can I view the content of outgoing messages?

To view outgoing message content you need to log into your CDYNE service dashboard. Expand the "Services and Usage" drop down on the left sidebar. Click "SMS Notify!" to view the usage of that specific service. Then click on a specific license key to view data. Move to the "Details" tab to see a breakdown of daily transactions. You can then choose to view the chart to see it for a selected date range.

Is it possible to assign a unique ID to each message/batch of messages for my organization’s internal tracking purpose?

Yes. When using the SendMessage method of the API, provide a value within the ReferenceID parameter. This value will be associated with each message within your request.

Short Code

How many messages can I send a day with a short code?

There is no limit to the number of messages you can send in a day with a short code. Messages sent through dedicated short codes are sent at a rate of 300 messages per second.

Can I have multiple short codes assigned to one key?

Yes.

Can I have one short code assigned to multiple keys?

Yes.

Can I manage keywords if I have a short code?

Yes.

How many keywords are offered with a dedicated short code?

With a dedicated short code, you can have unlimited keywords.

Long Code

What is a long code?

A long code is an SMS-capable phone number provided by CDYNE for use with the SMS Notify! API.

How long does it take for a long code to be assigned to my account?

A long code will be assigned to your account within one business day.

How many messages can I send a day with a long code?

We suggest sending up to 250 messages from one long code per day. Messages are sent at 1 message for every 2 seconds per long code.

Can you have multiple long codes assigned to one license key?

Yes.

Can I have one long code assigned to multiple license keys?

No.

Can I manage keywords if I have a long code?

You can manage your organization’s keywords through the use of a postback URL, but you cannot manage CDYNE’s API system keywords.