The official nodejs library for ClickSend v3 REST API

This is the official ClickSend SDK for Node.js. Complete documentation can be found here.

Requirements

• Sign Up for a free ClickSend account.
• Obtain your API credentials from the API Credentials area.
• Node.js v12 or higher

Installation

Install the ClickSend SDK

To install the SDK in your project, run:

npm install clicksend

That's it! No compilation or additional setup needed.

Documentation

Full documentation for the SDK and REST API is available here.

Quick Start

1. Basic Setup

Create an index.js file and require the ClickSend library:

constClickSend=require('clicksend');// Initialize the SMS APIconstsmsApi=newClickSend.SMSApi();// Set up authentication with your ClickSend credentialssmsApi.authentications.BasicAuth.username='YOUR_USERNAME';smsApi.authentications.BasicAuth.password='YOUR_API_KEY';

2. Send an SMS

functionsendSMS(){constsmsMessage=newClickSend.SmsMessage();smsMessage.to='+1234567890';// Recipient phone numbersmsMessage.body='Hello from ClickSend!';constsmsCollection=newClickSend.SmsMessageCollection();smsCollection.messages=[smsMessage];smsApi.smsSendPost(smsCollection).then((response)=>{console.log('SMS sent successfully:',response);}).catch((error)=>{console.error('Error sending SMS:',error.message);});}sendSMS();

3. Get SMS History

functiongetSMSHistory(){smsApi.smsHistoryGet().then((response)=>{console.log('SMS History:',response);}).catch((error)=>{console.error('Error retrieving SMS history:',error.message);});}getSMSHistory();

Running the Example

To run the included example:

1. Update the credentials in index.js:

   smsApi.authentications.BasicAuth.username='your_username';smsApi.authentications.BasicAuth.password='your_api_key';

2. Update the phone number and message as needed

3. Run the script:

   node index.js

Available Methods

The SMSApi provides the following methods:

• smsSendPost() - Send SMS messages
• smsHistoryGet() - Retrieve SMS history
• smsHistoryExportGet() - Export SMS history

Error Handling

Always wrap API calls in try-catch blocks or handle promise rejections:

smsApi.smsSendPost(smsCollection).then((response)=>{console.log('Success:',response);}).catch((error)=>{console.error('Failed:',error.message);});

Support

For issues, feature requests, or support, visit the ClickSend Developer Portal.

License

ISC