Build with the API developers recommend

Clean REST endpoints, signed webhooks, and a sandbox that behaves like production. Everything you need to ship communication features fast.

Developer Portal

Everything in one place

Jump straight to the part of the platform you need.

API Documentation

Complete REST reference with request/response examples for every endpoint.

Authentication

Scoped API keys with rotation, IP allowlists, and per-key rate limits.

Webhooks

Signed, retried event deliveries for message status and inbound traffic.

Postman Collection

Import every API request into Postman and start testing in one click.

Getting Started

From API key to first delivered message in under five minutes.

Getting Started

First message in five minutes

1Create a free account and grab your sandbox API key
2Copy a ready-made request from the docs or Postman collection
3Send a test message to your verified number
4Add a webhook endpoint to receive delivery events
5Swap to a live key and go to production

Get your API key

send-message.ts — REST API

const response = await fetch(
  "https://api.messagecrafts.com/v1/messages",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.MC_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      channel: "whatsapp",
      to: "+14155550142",
      template: "order_shipped",
      variables: { order_id: "4821" },
      fallback: ["sms"],
    }),
  }
);

const message = await response.json();
console.log(message.id, message.status);

Authentication

Scoped keys, serious security

• Bearer-token auth over TLS 1.2+ on every request
• Separate sandbox and live keys with independent scopes
• Per-key permissions: send, read, manage, billing
• IP allowlists and one-click key rotation
• Full audit trail of key usage in the dashboard

Authentication

# All API requests are authenticated with a Bearer token.
# Create scoped keys in the dashboard: Settings → API Keys.

curl https://api.messagecrafts.com/v1/account \
  -H "Authorization: Bearer mc_live_9f2c8e7a..."

API Reference

Sample request & response

Predictable, resource-oriented endpoints. JSON in, JSON out, meaningful HTTP status codes throughout.

Request — POST /v1/messages

POST /v1/messages HTTP/1.1
Host: api.messagecrafts.com
Authorization: Bearer mc_live_9f2c8e7a...
Content-Type: application/json

{
  "channel": "sms",
  "to": "+14155550142",
  "from": "MSGCRAFTS",
  "body": "Your MessageCrafts verification code is 482910.",
  "callback_url": "https://example.com/webhooks/status"
}

Response — 201 Created

HTTP/1.1 201 Created
Content-Type: application/json

{
  "id": "msg_01J8ZQ4K2N",
  "status": "accepted",
  "channel": "sms",
  "to": "+14155550142",
  "segments": 1,
  "price": { "amount": "0.0068", "currency": "USD" },
  "created_at": "2026-08-01T10:24:08Z"
}

Webhooks

Real-time events, delivered reliably

Subscribe to delivery receipts, inbound messages, and account events. Every payload is HMAC-signed, and failed deliveries retry with exponential backoff for up to 24 hours.

• message.accepted, message.delivered, message.failed
• message.inbound for two-way conversations
• otp.verified and otp.expired for verification flows
• Replay any event from the last 30 days via API

Webhook event payload

// Webhook payload — POST to your callback_url, signed
// with an HMAC-SHA256 signature in X-MC-Signature.
{
  "event": "message.delivered",
  "message_id": "msg_01J8ZQ4K2N",
  "channel": "sms",
  "to": "+14155550142",
  "delivered_at": "2026-08-01T10:24:11Z",
  "carrier": "T-Mobile US"
}

Postman Collection

Every endpoint, pre-configured with environment variables for sandbox and live keys. Fork it and start sending in one click.

Download the collection

Start building today

Free sandbox access, no credit card required. Your first hundred test messages are on us.

Get API Access Book a Demo

# All API requests are authenticated with a Bearer token. # Create scoped keys in the dashboard: Settings → API Keys. curl https://api.messagecrafts.com/v1/account \ -H "Authorization: Bearer mc_live_9f2c8e7a..."

POST /v1/messages HTTP/1.1 Host: api.messagecrafts.com Authorization: Bearer mc_live_9f2c8e7a... Content-Type: application/json { "channel": "sms", "to": "+14155550142", "from": "MSGCRAFTS", "body": "Your MessageCrafts verification code is 482910.", "callback_url": "https://example.com/webhooks/status" }

HTTP/1.1 201 Created Content-Type: application/json { "id": "msg_01J8ZQ4K2N", "status": "accepted", "channel": "sms", "to": "+14155550142", "segments": 1, "price": { "amount": "0.0068", "currency": "USD" }, "created_at": "2026-08-01T10:24:08Z" }

Real-time events, delivered reliably

Subscribe to delivery receipts, inbound messages, and account events. Every payload is HMAC-signed, and failed deliveries retry with exponential backoff for up to 24 hours.

• message.accepted, message.delivered, message.failed

• message.inbound for two-way conversations

• otp.verified and otp.expired for verification flows

• Replay any event from the last 30 days via API

// Webhook payload — POST to your callback_url, signed // with an HMAC-SHA256 signature in X-MC-Signature. { "event": "message.delivered", "message_id": "msg_01J8ZQ4K2N", "channel": "sms", "to": "+14155550142", "delivered_at": "2026-08-01T10:24:11Z", "carrier": "T-Mobile US" }