A2P Messaging API
A2P Messaging API
Send messages straight from your code — built for developers and AI agents. A simple REST API (and SMPP) with delivery tracking and webhooks: SMS today, with RCS and WhatsApp coming soon. No audience to manage: bring your recipients and send.
The A2P Messaging API is how your code sends messages through Instasent. It connects your application to carrier networks, delivering to handsets in 200+ countries, and covers everything around the send: single or batched sending, DLRs and inbound, message history, HLR lookups, price profiles and account balance. Today it sends SMS; RCS and WhatsApp are coming soon.
Two transports expose the same underlying pipeline. Pick the one that fits your stack — most teams start with HTTP and only move to SMPP when volume or session-state requirements justify it.
JSON over HTTPS. Best for application servers, serverless functions and anything that already speaks REST. Webhook-based DLRs.
SMPPPersistent TCP sessions, binary protocol. Best for wholesale SMS and high-throughput platforms (messaging providers, aggregators) that already operate an SMPP stack.
What you can do
- Send SMS, one at a time —
POST /smsfor triggered traffic (OTPs, alerts, receipts, notifications). - Send SMS in bulk —
POST /sms/bulktakes a collection of messages in a single request. This is the endpoint for API-driven campaigns, marketing fan-outs and any high-volume dispatch. Customers including marketing agencies run entire campaigns on top of it. - Receive delivery reports (DLRs) as carriers report status back through the chain, pushed to your webhook in real time.
- Accept inbound messages when the account has two-way enabled.
- Query message history and per-message status —
GET /sms,GET /sms/{id}. - Run HLR / number lookups —
POST /lookup,GET /lookup/{id}andGET /lookupto check handset presence and routing before sending. - Read account balance —
GET /organization/account. - Read price profiles —
GET /sms/price-profile/me/countriesandGET /lookup/price-profile/me/countriesfor per-country pricing.
When to use this API
Reach for A2P Messaging whenever your code needs to send — one message or many — without asking Instasent to manage the recipient audience. Typical workloads:
- User-triggered messages — OTPs, password resets, receipts, shipping notifications. One message per event, delivered in seconds, via
POST /sms. - API-driven campaigns and bulk dispatch — marketing sends, notification fan-outs, anything that fires many messages in one go. Use
POST /sms/bulk. - Wholesale SMS over SMPP — aggregators, messaging platforms and resellers pushing their own traffic through Instasent. SMPP gives carrier-grade throughput over persistent sessions; HTTP also works at moderate rates.
- Pre-send validation and pricing — HLR lookup and price profiles to route and cost-check before dispatch.
If you need Instasent to own the audience, personalization, segmentation and attribution, use the Product API instead — it delegates delivery to this one but adds the customer-data layer on top. The A2P Messaging API is the right pick when the caller already manages its recipient list and just needs to send.
What to read next
Send your first SMS over REST in under five minutes.
Bulk sendingUp to 100 messages per request, queue-based dispatch, the endpoint for API-driven campaigns.
HTTP AuthenticationToken types, header vs. query string, rotation.
Receiving DLRsWebhook payload, status list, two-way inbound.
Full API ReferenceEvery endpoint, every parameter.