# Contact Database Source: https://docs.terrareach.com/add-contacts How to add contacts to your account In order to run a successful SMS campaign for your business, you need to have a good contact database of your clients. If you have contacts, go to the "Contacts" tab. TerraReach Contact Tab

Then you’ll be directed to the "Contacts" page where you can add contacts to your account. Here, you can add contacts one by one or by using a CSV file that contains a large number of contacts. TerraReach Contact Page

If you click on the "New Contact" button, a modal will appear to add contact details. Here, you can add each contact detail one by one if you have only a few contacts to add. Additionally, you can create contact groups for better organization of your contacts. TerraReach New Contact

If you click on the "Upload Contacts" button, a modal will appear where you can upload contacts using a CSV file. You can drag and drop a CSV file or click on the "Choose CSV File" button to add it. Here, you can also create a group for your uploaded contacts. TerraReach Upload Contacts

Once added, these contacts will be displayed like this for you to create SMS campaigns. TerraReach Contact Data

# Send Bulk SMS Source: https://docs.terrareach.com/api-reference/endpoint/v1/sendbulksms POST /v1/sms/bulk # Send SMS Source: https://docs.terrareach.com/api-reference/endpoint/v1/sendsms POST /v1/sms # Get Stats Source: https://docs.terrareach.com/api-reference/endpoint/v1/stats GET /v1/sms # Introduction Source: https://docs.terrareach.com/api-reference/introduction API endpoints of TerraReach to integrate with 3rd party apps. This section is for developers. If you're not looking to integrate TerraReach to your app, you can skip this section. ## Welcome The comprehensive guide to connect TerraReach to your application and start sending SMS. ## Prerequisites You should complete these steps before using the API 1. [Register With TerraReach](https://app.terrareach.com/sign-up) 2. [Create an API Key](https://app.terrareach.com/settings/api-keys) # Product Updates Source: https://docs.terrareach.com/changelog/overview New updates and improvements ## Updates and Improvements * Upgrated UI * Updated reload min, max values as 250 and 10,000 ## Bug Fixes * Resolve contact searching issue in quick send form * Fixed phone number formatting ## Updates and Improvements * Changed backend technology * Added group name checking ## Bug Fixes * Fixed delete mask issue * Fixed customer ID change when recharging ## Updates and Improvements * Create campaign by uploading contacts CSV file * Updated Sender ID request form hints ## Bug Fixes * Fixed sms count issue ## Updates and Improvements * FormsDeck widget added for support ## Updates and Improvements * Added sender id character limit * New helper info added to the mask request form * BR, domain registration document inputs added to the mask request form * Purpose field removed from the mask request form * Custom numbers field included into the quick sms form ## Updates and Improvements * Added Sender ID exceeded alert ## Bug Fixes * Fixed content type issue Initial release # Credits Reload Source: https://docs.terrareach.com/credits-reload How to reload credits to send SMS using your business name ## Settings Click on your name to open the dropdown menu, which contains the billing page. TerraReach Billing Button

After clicking on the billing link, you'll be directed to the billing page. Here, click on the "Reload" button. TerraReach Billing Page

Then you'll see a modal to select the amount of credits you want to reload. Choose an amount based on your SMS sending requirements and check agree to refund policy. Finally click on the "Proceed to Reload" button. TerraReach Reload Credits

Then you'll be redirected to the payment gateway to complete the payment. # Calculating the cost for a SMS Source: https://docs.terrareach.com/general/cost-for-a-sms How do we calculate the cost for a SMS Cost for an SMS is calculated based on the number of characters in the particular message text. As an example, if you send an SMS with “Where are you?” as the text, it has 14 characters. One SMS can be 160 characters in length. You can send longer messages using a process called concatenation. We use special characters to join the SMS together and deliver them as one message. Due to the use of characters to join the messages, there are inconsistencies in the length of the following SMS. ### Number of pages vs number of Characters Upto 160 Characters = 1 page 160\< Characters = 2 pages 306\< Characters = 3 pages 459\< Characters = 4 pages As an example, if you send a message with 161 characters, you will be charged twice of your SMS price because you are sending two SMS pages in your message. Your recipient will receive the message as a single message, but technically if it has more than 160 characters you are sending multiple SMS connected together. ### spaces and line breaks Each line break and space adds to your character count. 1 whitespace = 1 character 1 line break = 2 characters ### Shortcodes in messages We count the text after any shortcodes are resolved. It's safe to keep a safe margin by having an estimate of how long the shortcode’s final replacement text will take from your message. ### Unicode content When SMS messages contain characters not found in the GSM-7 character set, we call it an Unicode SMS. An SMS allows up to 160 characters with the GSM-7 character set, which includes all latin characters (A-Z), digits (0-9), and a few special characters. Unicode can handle any known character but takes more SMS space than GSM's 7-bit binary code. With that situation, SMS messages with unicode content are limited to 70 characters, and SMS content longer than this will be segmented. Upto 70 Characters = 1 page 70\< Characters = 2 pages 134\< Characters = 3 pages 201\< Characters = 4 pages please note that every condition and network rule described above are according to the international standards and none of them were made by TerraReach or the parent company. # Pricing Source: https://docs.terrareach.com/general/how-pricing-works Learn how pricing works ## Pay & Go **Per SMS Cost**: **LKR 0.80** (tax included) **Free SMS Credits**: 20 ### Features * No Setup/Registration Fees * No Monthly / Yearly Fees * Web Dashboard Access * සිංහල/தமிழ் (Unicode) Support * Free Sender ID (Masking) * Developer REST API * Easy Integrations * Unlimited Contacts * Delivery Reports * Secure Online Payments * One-click CSV Import * No Credit Expiry Last updated on 2025-12-20 All Taxes and Fees are Included in the Above Prices. Mentioned “SMS Cost” and “Free SMS” count is valid for transactional SMS. For marketing/promotional SMS an additional tax (25 cents) will be imposed. [More about how we calculate the cost for a SMS](/general/cost-for-a-sms) ### Additional details * You receive 20 free SMS credits to start. * Your SMS credits never expire. * Top up your account with more credits whenever you need to send messages. * A free Sender ID is included with your account. * One simple Pay & Go plan for everyone. Use what you need, when you need it. Send more than 50,000 SMS per month? WhatsApp us at [+94 77-62-52-120](https://wa.me/94776252120?text=I%20send%20more%20than%2050,000%20messages.%20Could%20you%20give%20me%20custom%20a%20package?) for custom packages. # Introduction Source: https://docs.terrareach.com/introduction Welcome to the home of TerraReach documentation Hero Light

## Setting Up Let’s set up your account and start sending SMS that drives revenue in minutes. Experience the effortless onboarding for a seamless start A comprehensive API reference for seamless integration ## About Discover the power of TerraReach, your premier SMS gateway provider catering specifically to Sri Lanka. With extensive coverage, TerraReach enables you to effortlessly send SMS to any phone number across networks, ensuring delivery to devices equipped with SMS-receiving capability. See pricing plans and how the cost is applied to SMS See Terms of Service to use TerraReach # Privacy Source: https://docs.terrareach.com/legal/privacy-policy TerraReach privacy policy for customers ### Introduction Welcome to TerraReach. We are committed to protecting the privacy of our users. This Privacy Policy explains how we collect, use, disclose, and safeguard your information when you use our SMS marketing service. ### Information We Collect **Personal Information:** This may include your name, email address, phone number, and any other information you provide when you sign up for our service. **Usage Data:** Information about how you use our service, including your messaging campaigns, recipient responses, and other engagement metrics. **Technical Data:** This includes IP addresses, browser types, and other technical details about the device used to access our services. ### How We Use Your Information **To Provide Our Service:** We use your information to operate and maintain our SMS marketing platform. **Communication:** We may use your information to communicate with you about your account, our services, and customer support. **Improvement of Services:** We analyze usage data to improve our service and develop new features. **Legal Compliance:** We may use your information to comply with applicable laws and regulations. ### Sharing of Information **Service Providers:** We may share your information with third-party service providers who perform services on our behalf. **Legal Requirements:** If required by law or in response to legal processes, we may disclose your information. **Business Transfers:** In the event of a merger, acquisition, or sale of assets, your information may be transferred as part of that transaction. ### Data Security We implement a variety of security measures to maintain the safety of your personal information. However, no system can be completely secure, and we cannot guarantee the absolute security of your information. ### Your Rights **Access and Control:** You have the right to access and control the personal information we hold about you. **Opt-Out:** You can opt-out of receiving marketing communications from us at any time. **Data Portability:** You have the right to request a copy of your data in a machine-readable format. ### Data Retention We retain your information for as long as your account is active or as needed to provide you our services, and as necessary to comply with our legal obligations. ### Changes to This Policy We may update this Privacy Policy from time to time. We will notify you of any significant changes by posting the new policy on our website. Contact Us If you have questions about this Privacy Policy, please contact us at [support@terrareach.com](mailto:support@terrareach.com) Last updated on 2024-01-22 # Terms Source: https://docs.terrareach.com/legal/terms-of-service Terms of service to use TerraReach ## Terms and Conditions agreement Legal contract between you (Customer) and TerraReach. Discover our terms and conditions agreement. ### 1. Introduction **Overview:** Welcome to TerraReach, a leading SMS marketing tool designed to help businesses effectively communicate with their customers. Our services include message automation, campaign management, and analytics. **Acceptance of Terms:** By using TerraReach, you agree to be bound by these terms and our privacy policy. If you do not agree, please do not use our services. ### 2. Use of Service **Eligibility:** You must be at least 18 years old to use TerraReach. **Account Responsibility:** You are responsible for maintaining the security of your account and password. TerraReach cannot and will not be liable for any loss or damage from your failure to comply with this security obligation. Permitted Use: TerraReach is to be used for your direct marketing campaigns and transactional messaging in compliance with all applicable laws and regulations. Customer undertakes to obtain and maintain any licenses, or approvals as are required under the applicable laws for carrying out its business and for offering the services at terminated destination. Customer undertakes to indemnify TerraReach and keep it indemnified against all liabilities, losses, costs damages, expenses, demands, proceedings, claims and actions TerraReach may suffer or incur (including all legal and other charges and expenses which may be incurred) of whatever nature and howsoever arising as a result of The Customer failure to obtain or maintain such licenses or approvals pursuant to this clause. ### 3. SMS Marketing Compliance **Compliance with Laws:** You agree to comply with all relevant laws and regulations, including the Telephone Consumer Protection Act (TCPA) and General Data Protection Regulation (GDPR). **Opt-in Requirements:** You must obtain express consent from individuals before sending them marketing messages. **Opt-out Mechanism:** Each message must include clear instructions on how the recipient can opt-out of future messages. ### 4. Sender ID The Customer should request desired Sender ID and should be approved by Us before available to use, text only (no numbers). Only to be used in a professional manner. TerraReach reserves all rights to reject or ask for any existing proof for a new Sender ID request. ### 5. Content Standards Prohibited Content: Messages must not contain offensive, threatening, defamatory, or otherwise objectionable content. The guidelines to be taken into consideration by the Customer, with regards to the contents shall include, but not be limited to the following: **a)** Messages and information sent as a result of spamming are not permitted. **b)** Messages, information, or programs of an explicitly or implicitly sexual nature are not permitted. **c)** Messages, information, or programs must not suggest encourage or incite any person to use harmful substances or engage in dangerous practices. **d)** Messages, information, or programs, which may be considered unsuitable for a general audience including children, shall not be permitted. **e)** Messages must not contain any notifications, advertising, promotional or marketing information of any mobile operator or a competitor of a mobile operator. **User Responsibility:** You will be solely responsible for writing and\or generating the SMS content and TerraReach shall not be responsible in any way for the SMS content, and the Customer shall indemnify TerraReach for any damages\losses may be incurred from such content. ### 6. Pricing, Fees and Refund Policy TerraReach operates on a Pay & Go plan. Users can reload their account balance at any time to continue using the service. Since our service is prepaid, there are no invoices or late fees. If your account balance reaches zero, you will not be able to send messages until you reload. Suspended or terminated accounts cannot be restored. TerraReach doesn’t offer any refund and any balance in the account can only be used to send SMS. ### 7. Credit/Debit Card Payments **Payment Gateway:**\ All credit and debit card payments accepted by us are processed exclusively through a third-party payment gateway service (**PayHere**). We do not collect, store, process, or retain any card information, including card numbers, expiration dates, or CVV/security codes. All payment details are securely handled in accordance with the payment gateway’s security standards and compliance requirements. **No Card Storage:**\ We do not provide a card-saving or tokenization feature. Card details entered during a transaction are used solely for that specific payment and are not retained for future transactions. **Manual Payments Only:**\ Automatic, recurring, or scheduled payments are not supported. All payments must be initiated manually by you for each invoice or transaction. All payments made through our platform are subject to our refund policy as outlined in **Clause 6**. ### 8. Limitation of Liability **Service Limitations:** TerraReach is provided on an “as is” and “as available” basis. We do not guarantee that our service will be uninterrupted or error-free. **Liability Clause:** TerraReach’s aggregate liability for all claims relating to the services shall not exceed the amounts paid by you to TerraReach under this agreement over the twelve (12) months preceding the claim. ### 9. Privacy Policy **Data Collection:** We collect information necessary to provide our services, including contact details and campaign data. **Data Protection:** We implement industry-standard security measures to protect your data. ### 10. Termination **Termination Rights:** TerraReach may terminate your access to all or any part of the services at any time if you breach these terms. **Effect of Termination:** Upon termination, all rights granted to you under these terms will immediately cease. ### 11. Miscellaneous **Amendments:** These terms may be updated from time to time. Continued use of the service following such changes constitutes your acceptance of the new terms. **Governing Law:** These terms shall be governed by the laws of Sri Lanka, without regard to its conflict of law provisions. **Contact Information:** For any questions about these terms, please contact us at [support@terrareach.com](mailto:support@terrareach.com) Last updated on 2024-01-22 # Registration Source: https://docs.terrareach.com/registration How to register to TerraReach ## Setup your Account Go to [terrareach.com](https://terrareach.com) website and click any of the button display below. TerraReach Register

Then you'll be directed to sign-up page as below. TerraReach Sign Up

Fill your data and verify your account. Then you'll be directed to a TerraReach dashboard like this with your free credits to test the platform.

# Request a Sender ID Source: https://docs.terrareach.com/request-a-senderid How to request a sender ID for your business ## Settings Click on the "Settings" tab. TerraReach Settings Button

After clicking on the "Settings" tab, you'll be directed to the settings page. Here, click on the "Sender ID" tab. TerraReach Sender ID

Then you'll see the default Sender ID you received when you registered on the platform. ### Sender ID TerraReach Sender ID Page

Click on the "Request Sender ID" button to open the form for requesting a Sender ID. TerraReach Sender ID button

Then you'll get the form. Download the template we've provided by clicking on the "Download" text. Update the relevant fields of that document, sign it (add a seal if you can), and save it as a PDF. Finally, upload it to the "Letter" field of this form. TerraReach Sender ID form

Fill out the other fields as well. Make sure to double-check your desired Sender ID for correctness, including spelling. It's case-sensitive and should only contain 11 characters. Check the usage type of the Sender ID and select whether you are using it for transactional or promotional SMS. Upload your domain purchase invoice if your Sender ID contains a domain name; otherwise, you can skip the domain registration field. If your business is registered, please upload the business registration (BR) document. By providing these necessary documents, your Sender ID approval process will be sped up. Transactional SMSes are automated messages containing important, time-sensitive information about an account or a transaction. Promotional SMSes are marketing and advertising messages. Sender ID approval process could take up to two business days. # Send SMS Source: https://docs.terrareach.com/send-sms How to run a successful SMS campaigns At TerraReach you have two ways to send SMS to your clients. One is clicking Send SMS button on the dashboard, TerraReach Quick Send

and the other one is going to campaign tab and click new campaign button. TerraReach Settings Button

If you click the "Send SMS" button, a modal will appear where you can send your SMS. There, you can select an individual contact or a group. In the "Sender ID" dropdown menu, you can choose from the available Sender IDs for your account to use as the Mask. If you don't see your Sender ID there and still need to request one, [here is how to do it.](/request-a-senderid) In the message field, you can type your message. It shows how many characters are in your message. The charge for the SMS will vary according to the length of your message. [Here is how the cost for an SMS is calculated.](/general/cost-for-a-sms) TerraReach Quick Send Modal

After filling all the required fields, click on the "Send" button to send this message instantly to your selected contact list. If you click on the "New Campaign" button on the campaign page, a modal will appear where you can create a campaign. There, you can add a campaign title for better organization, select a sender ID, contact group, campaign type (Quick/Schedule), and add the message. The conditions for the sender ID and the message are the same as above. TerraReach Campaign Modal

Champaign scheduling is not implemented yet to the platform. We're working on it.