Sendme API

The Sendme API allows you to manage contacts and send communications via SMS and email in a simple and efficient way.

Getting Started

Before you begin, you need to:

1. Get your API Key: Register at app.sendme123.com
2. Set up authentication: Check the authentication documentation
3. Explore endpoints: Use the contacts and messages sections

Main Sections

Authentication

Learn how to authenticate with the API using API Keys or JWT tokens.

View authentication →

Contacts

Manage your contact database: create, query, update and delete.

View contacts →

Messages

Send communications via SMS and email to your contacts.

View messages →

Quick Start

Here’s a basic example to get you started:

// Set up authentication
const headers = {
  'api-key': 'your-api-key-here',
  'Content-Type': 'application/json'
};

// Create a contact
const createContact = async () => {
  const response = await axios.post('https://app.sendme123.com/api/contacts', {
    name: 'John Doe',
    phone: '3001234567',
    email: '[email protected]'
  }, { headers });

  return response.data;
};

// Send SMS
const sendSMS = async () => {
  const response = await axios.post('https://app.sendme123.com/api/messages/send/sms', {
    type: 'sms',
    message: 'Welcome to our service!',
    contacts: ['3001234567'],
    countryCode: '57'
  }, { headers });

  return response.data;
};

Base URL

All API requests should be made to:

https://app.sendme123.com/api

Response Format

All responses follow a consistent JSON structure:

{
  "data": "...",
  "message": "Success message",
  "status": "success"
}

For paginated responses:

{
  "data": [...],
  "pagination": {
    "currentPage": 1,
    "totalPages": 5,
    "totalItems": 87,
    "itemsPerPage": 20
  }
}