Changelog
A chronological record of platform updates, new features, and important changes to Sent's APIs and services.
API v3
Overview
Sent API v3 is the current major version, featuring a redesigned authentication system, consistent response formats, and expanded functionality for multi-channel messaging.
Key Changes from v2
| Feature | v2 | v3 |
|---|---|---|
| Authentication | x-sender-id + x-api-key headers | x-api-key header only |
| Response Format | FastEndpoints problem details | Consistent JSON envelope |
| Property Naming | Mixed case | snake_case |
| Test Mode | Not available | test_mode field in body |
| Idempotency | Not available | Idempotency-Key header |
| Error Codes | Limited | Comprehensive error catalog |
| Profiles | Limited | Full CRUD operations |
| Brands/Campaigns | Not available | Full 10DLC support |
| Users | Not available | Organization management |
| Webhooks | v2 endpoints | Enhanced v3 webhooks |
2024
December 2024
API v3 General Availability
- Added: Sent API v3 is now the recommended version for all integrations
- Added: Comprehensive API documentation for v3 endpoints
- Added: New getting started guide for v3
November 2024
Webhook Enhancements
- Added:
GET /v3/webhooks/event-typesendpoint to list available event types - Added:
POST /v3/webhooks/{id}/testendpoint to test webhook delivery - Added:
POST /v3/webhooks/{id}/rotate-secretendpoint for security rotation - Added:
PATCH /v3/webhooks/{id}/toggle-statusendpoint to enable/disable webhooks
User Management
- Added:
GET /v3/usersandGET /v3/users/{id}for user listing and details - Added:
POST /v3/usersto invite users to your organization - Added:
PATCH /v3/users/{id}to update user roles - Added:
DELETE /v3/users/{id}to remove users
October 2024
10DLC Compliance (Brands & Campaigns)
- Added: Brand registration endpoints for 10DLC compliance
POST /v3/brands- Create brandGET /v3/brands- List brandsPUT /v3/brands/{id}- Update brandDELETE /v3/brands/{id}- Delete brand
- Added: Campaign management endpoints
POST /v3/brands/{id}/campaigns- Create campaignGET /v3/brands/{id}/campaigns- List campaignsPUT /v3/brands/{id}/campaigns/{id}- Update campaignDELETE /v3/brands/{id}/campaigns/{id}- Delete campaign
Profile Management
- Added: Full profile CRUD operations
POST /v3/profiles- Create profileGET /v3/profiles- List profilesGET /v3/profiles/{id}- Get profile detailsPATCH /v3/profiles/{id}- Update profileDELETE /v3/profiles/{id}- Delete profile
- Added:
POST /v3/profiles/{id}/completefor profile setup completion
September 2024
API v3 Beta Release
- Added: Core messaging endpoints
POST /v3/messages- Send messagesGET /v3/messages/{id}- Get message statusGET /v3/messages/{id}/activities- Get message activities
- Added: Contact management
GET /v3/contacts- List contactsPOST /v3/contacts- Create contactGET /v3/contacts/{id}- Get contactPATCH /v3/contacts/{id}- Update contactDELETE /v3/contacts/{id}- Delete contact
- Added: Template management
GET /v3/templates- List templatesPOST /v3/templates- Create templateGET /v3/templates/{id}- Get templatePUT /v3/templates/{id}- Update templateDELETE /v3/templates/{id}- Delete template
- Added: Webhook management
GET /v3/webhooks- List webhooksPOST /v3/webhooks- Create webhookGET /v3/webhooks/{id}- Get webhookPUT /v3/webhooks/{id}- Update webhookDELETE /v3/webhooks/{id}- Delete webhookGET /v3/webhooks/{id}/events- List webhook events
- Added: Number lookup
GET /v3/lookup/number/{phone}- Lookup phone number information
- Added: Account information
GET /v3/me- Get authenticated account details
New Features
- Added: Test mode (
test_mode: true) for all mutation endpoints - Added: Idempotency key support via
Idempotency-Keyheader - Added: Consistent JSON response envelope (
success,data,error,meta) - Added: Standardized error codes with documentation URLs
- Added: snake_case property naming convention
- Added: Enhanced rate limiting with detailed headers
2023
Legacy API v2
The v2 API remains fully supported for existing integrations. All v2 endpoints continue to operate at /v2/ paths.
Key v2 endpoints:
POST /v2/messages/contact- Send message to contactPOST /v2/messages/phone- Send message to phone numberGET /v2/contacts- List contactsGET /v2/templates- List templates
See Legacy API Reference for complete v2 documentation.
Deprecation Notices
API v2
- Status: Legacy (still supported)
- Recommendation: New integrations should use v3
- End of Support: No end date announced
Upcoming Changes
Planned for 2025
- Analytics API: Message delivery analytics and reporting endpoints
- Bulk Operations: Endpoints for batch contact and message operations
- Advanced Templates: Template versioning and A/B testing support
- SDKs: Official client libraries for JavaScript, Python, and Go
Subscribe to our API Status page for real-time updates on API changes and service status.
Feedback
Have suggestions for API improvements? Contact us at support@sent.dm.