Authentication

The Sendme API uses API Key-based authentication to protect all endpoints.

Supported Authentication Types

1. API Key (Recommended)

Include your API key in the api-key header of each request.

GET /api/contacts
Host: app.sendme123.com
api-key: your-api-key-here
Content-Type: application/json

2. JWT Bearer Token

You can also use a JWT Bearer token in the authorization header.

GET /api/contacts
Host: app.sendme123.com
Authorization: Bearer your-jwt-token-here
Content-Type: application/json

Getting Your API Key

To obtain your API Key:

1. Sign up at https://app.sendme123.com
2. Create your account and verify your email
3. Access the admin panel
4. Go to the “Settings” or “API Keys” section
5. Generate your personal API Key

Authentication Response Codes

Code	Description
401	Missing or invalid API Key
403	Valid API Key but insufficient permissions
429	Request limit exceeded

Usage Examples

cURL

curl -X GET "https://app.sendme123.com/api/contacts" \
  -H "api-key: your-api-key-here" \
  -H "Content-Type: application/json"

JavaScript

const getContacts = async () => {
  try {
    const response = await axios.get('https://app.sendme123.com/api/contacts', {
      headers: {
        'api-key': 'your-api-key-here',
        'Content-Type': 'application/json'
      }
    });

    console.log('Contacts retrieved:', response.data);
    return response.data;
  } catch (error) {
    console.error('Authentication error:', error.response?.data || error.message);
    throw error;
  }
};

Python

import requests

headers = {
    'api-key': 'your-api-key-here',
    'Content-Type': 'application/json'
}

response = requests.get('https://app.sendme123.com/api/contacts', headers=headers)
data = response.json()