Contacts API
Overview

Contacts API

The SMSLeopard Contacts API allows you to programmatically manage and segment your SMS contacts — directly from your application, CRM, or backend system.

It ensures your contact list is always:

  • Up-to-date — reflecting real-time changes from your customer database
  • Segmented — so you can organize contacts into groups like “VIPs”, “New Signups”, or “Overdue Customers”
  • Personalized — using custom metadata like name, account number, region, spend level, and more

With just a few API calls, you can:

  • Add new contacts as users sign up, transact, or change plans
  • Assign contacts to one or more predefined groups
  • Tag contacts with metadata for personalization in your SMS templates
  • Keep your messaging list always ready for broadcast

Whether you’re sending reminders, promotions, or service updates — the Contacts API helps you send the right message to the right people at the right time, without manual uploads or outdated lists.

Real-Time Sync with Your Systems

Whenever a user signs up, makes a purchase, updates their profile, or cancels — your system can update SMSLeopard contacts instantly via the API.

That means:

  • No more messy spreadsheets
  • No more forgotten customer segments
  • No more outdated contact info slowing down your campaigns

Base URL

https://api.smsleopard.com/v1/

Authentication

This API uses Basic Authentication with your API credentials. Click to Generate Credentials (API Keys and Secrets) (opens in a new tab)

  • Username: {api_key}
  • Password: {api_secret}

Each request must include the Authorization header in the following format:

Authorization: Basic <base64(api_key:api_secret)>
# Set your credentials
API_KEY="your_api_key"
API_SECRET="your_api_secret"
 
# Example: Fetch groups
curl -X GET "https://api.smsleopard.com/v1/groups/fetch" \
  -u "$API_KEY:$API_SECRET"

Available Endpoints

ExamplesFetch Groups