Sendme API Documentation

Main Features

API Key Authentication

Simple and secure authentication system using API keys to protect all endpoints.

Contact Management

Create and manage contacts with detailed information for your communications.

SMS Sending

Send SMS messages programmatically with delivery confirmation.

Email Sending

Send personalized emails with support for HTML and plain text.

Available Endpoints

Authentication

Learn how to authenticate using API Keys or JWT tokens. View documentation →

Contacts

Complete CRUD for managing contacts with advanced filters and pagination. View documentation →

Messages

Send SMS and emails, check history and manage mass communications. View documentation →

Get Started

To start using the Sendme API:

1. Get your API Key: Register at app.sendme123.com to obtain your access credentials
2. Create contacts: Register the recipients of your communications
3. Send messages: Use the SMS or email endpoints to communicate

Popular Use Cases

Basic Integration

// Create contact and send welcome SMS
const createContactAndSendSMS = async () => {
  try {
    const contact = await axios.post('https://app.sendme123.com/api/contacts', {
      name: 'John Doe',
      phone: '3001234567'
    }, {
      headers: { 'api-key': 'your-api-key', 'Content-Type': 'application/json' }
    });

    await axios.post('https://app.sendme123.com/api/messages/send/sms', {
      type: 'sms',
      contacts: ['3001234567'],
      message: 'Welcome to our platform!',
      countryCode: '57'
    }, {
      headers: { 'api-key': 'your-api-key', 'Content-Type': 'application/json' }
    });

    console.log('Contact created and SMS sent');
  } catch (error) {
    console.error('Error:', error.response?.data || error.message);
  }
};

Mass Communication

// Send email to all active contacts
const sendMassEmail = async () => {
  try {
    await axios.post('https://app.sendme123.com/api/messages/send/email', {
      subject: 'Important Update',
      message: 'Email content...',
      contacts: ['[email protected]', '[email protected]']
    }, {
      headers: { 'api-key': 'your-api-key', 'Content-Type': 'application/json' }
    });

    console.log('Mass email sent');
  } catch (error) {
    console.error('Error:', error.response?.data || error.message);
  }
};