Skip to main content

Overview

Welcome to the PaaSoo Telecom Services API.

PaaSoo is dedicated to building stable and efficient cloud communication solutions for global enterprises. Our REST APIs provide a rich variety of communication capabilities, helping developers seamlessly integrate global reach services into your applications to achieve fast, high-quality, and scalable global communication.

Through the PaaSoo API, you can freely combine functional modules such as SMS, MMS, Voice, and Phone Number Lookup to easily build various business scenarios including marketing promotion, OTP distribution, and customer service.

All REST APIs follow uniform design specifications, support HTTP/HTTPS requests, use JSON data format for interaction, and use UTF-8 encoding.

Security Recommendation

To ensure data confidentiality and security, we strongly recommend that you use the HTTPS protocol to call the API in a production environment to prevent data from being eavesdropped or tampered with during transmission.

This developer documentation is divided into subdirectories by functional modules, and you can refer to the relevant interfaces as needed:

Core Concepts​

Before you start integrating the API, please understand the following core concepts:

1. API Key & API Secret​

The API Key and API Secret are your exclusive credentials to access the PaaSoo REST APIs, each consisting of 8 alphanumeric characters. All API requests rely on these credentials for authentication.

You can get your exclusive key pair in the PaaSoo console. To ensure the security of your assets and account, please be sure to follow the best practices below:

  • Keep Safe: Never hardcode the API Secret in the client (such as Apps, frontend web pages) or submit it to a public code repository.
  • Environment Isolation: It is recommended to combine security strategies such as server-side verification and IP Whitelist to prevent malicious abuse.
  • Encrypted Transmission: Be sure to transmit requests encrypted via HTTPS to prevent key leakage.

2. Sender ID​

Sender ID refers to the sender name displayed on the recipient's terminal device. Common formats include:

  • Numeric format: Standard E.164 formatted phone numbers (for example: +12025550123).
  • Alphanumeric format: Custom strings containing letters and numbers (for example: MyPromo123).

The PaaSoo platform supports a Sender ID of up to 20 characters. When using the API to pass a custom Sender ID (usually via the from parameter), please note the following:

  • URL Encoding: If the Sender ID contains special characters or spaces, be sure to URL Encode (UTF-8) it before passing the parameter.
  • Compliance and Restrictions: The regulatory policies of operators in different countries/regions on Sender ID vary greatly. Some countries support dynamic custom Sender IDs, while some countries strictly require that they must be pre-registered and reported to local operators before they can be used.
  • Display Guarantee: Due to local operator policy restrictions, PaaSoo cannot guarantee that the custom string you pass in the from parameter can be displayed as expected in all target countries/regions. If you have specific market Sender ID requirements (such as registering an exclusive Sender ID), please contact your dedicated account manager or technical support team.
Support

If you encounter any technical issues or have business inquiries during the API integration, please do not hesitate to contact our Support team at support@paasoo.com. We are always here to assist you.