Legacy API Notice: This documentation covers the Legacy Sent API (v2). While this API remains fully supported, we recommend new integrations use the latest Sent API v3 for enhanced features, improved performance, and long-term support.
Sent Legacy v2 API
The Legacy Sent API (v2) is a REST API for sending messages, managing contacts and templates, and looking up phone numbers. For a walkthrough of sending your first message, follow the Quickstart Guide.
Quick Start
Base URL
https://api.sent.dmAuthentication
Every v2 request requires two authentication headers:
x-sender-id: YOUR_SENDER_ID
x-api-key: YOUR_API_KEYx-sender-id: Your unique sender/customer identifierx-api-key: Your secret API key
Generate credentials on the API Keys page of your Sent Dashboard. For setup steps, header formats, and 401 error responses, see the v2 Authentication guide.
Endpoint Documentation
Messages API
Send messages to contacts or phone numbers and retrieve message details by ID.
Contacts API
List contacts and look them up by ID or phone number.
Templates API
List, create, retrieve, and delete message templates.
Try with Postman
Import the v2 collection into Postman to explore the legacy endpoints. For new integrations, use the v3 collection instead:
Run in Postman: Directly fork Sent DM API v2 (Legacy) to your workspace
Import Collection: Open collection in Postman for manual import
Authentication & Security
Authentication Guide
Required request headers, credential setup, and 401 error responses for the v2 API.
Rate Limits
Per-minute limits on the send endpoints, the quick-message daily cap, and 429 response headers for the v2 API.
API Reference Documentation
Data Models
Request and response schemas, field definitions, and data validation rules for the v2 endpoints.
Error Reference
HTTP status codes and the problem-details error response format for the v2 API.
Error Catalog
Specific error codes with root causes and step-by-step remediation instructions.
Integration Guides
Message Integration
Message sending patterns, channel optimization, and delivery practices.
Contact Management
Contact management strategies, segmentation patterns, and preference handling.
Template Management
Template creation workflows, approval processes, and multi-language template strategies.
Webhooks Setup
Real-time event handling with webhook endpoints, security validation, and retry logic.
Support & Resources
Documentation
- Quickstart Guide - Complete onboarding walkthrough
- Support Center - FAQs, troubleshooting, and community resources
- API Status - Real-time service status and incident reports
Get Help
- Email Support: support@sent.dm