The following checklist is mandatory to use Kaleyra SMS API:

Mobile Phone Number Format

All mobile phone numbers should be valid with the country code for global messaging. The country code for domestic messaging (India) may or may not be applied.


Example: +91999999999, 918888888888, +441234567890, +254123456789

Sender ID

All text messages carry a sender ID. When you send a text message through API, you could use any of the approved sender IDs for your account.

In case you have not created a sender ID, you can always create one through our SMS application. Once the Sender ID is approved, you can start sending messages.


Creating a Sender ID


A SenderID is a string of 6 alphabetic characters that represent your company name and becomes the identifier for your customer when they receive a message with your senderID.

Your sender IDs must now be registered towards India as per the directive by TRAI, on the DLT portal. To know more about this, you may refer to this article.


Once your Sender IDs are added on the DLT platform, sign in to your Kaleyra Alerts or Promotional platform and add them as per the steps mentioned here.

Creating a Template

The next process to send an SMS is to create a template. A template is a pre-defined version of an SMS that contains replaceable variables and a default format.

Again, as per the TRAI directive, the intended message content should also be registered on the DLT platform. To find out how to do this, refer to this article.


Once your Templates are added on the DLT platform, sign in to your Kaleyra Alerts or Promotional platform and add them as per the steps mentioned here.



Generating API Key

Once you have an active account with us, you can generate an API Key from our SMS application. The following are the steps to follow to generate an API Key:

  1. Login to Alerts/ Promo/ Global Application
  2. Click on the 'Developer' section from the left menu
  3. Click on API Keys and click on Resend Button
  4. The API key will be sent to your registered email ID.

API Key

You can request for an API key any number of times from your SMS account and the same will be delivered to the registered email ID.