Messaging

Integrate powerful, programmable, high-throughput SMS and MMS with SignalWire APIs, SDKs, and no-code application builders

Programmable Messaging is deeply integrated in the SignalWire platform. Our robust APIs, SDKs, and application builders are backed by first-class support and a team dedicated to compliance and class-leading delivery rates across all carriers and locations.

SignalWire is your Messaging partner from proof-of-concept to deployment. Get up and running quickly with our Getting Started guides, test your application with our Platform Free Trial, and get registration right the first time with our comprehensive Guide to The Campaign Registry (TCR).

Try it out

Relay Realtime SDK (Server)
CXML

Relay Realtime SDK (Server)

import { SignalWire } from "@signalwire/realtime-api";

const client = await SignalWire({ project: "ProjectID Here", token: "Token Here"})

await client.messaging.listen({
  topics: ["office"],
  async onMessageReceived(message) {
    client.messaging.send({
        to: "+1xxxxxxxxxx",
        from: message.to,
        body: `
        You received a message from ${message.from} to SignalWire number ${message.to}.
        The message was: ${message.body}
        `
    })
  }
})

CXML

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Message to="+1xxxxxxxxxx">
        You received a message from: {{From}} to SignalWire number: {{To}}.
        The message is: "{{Body}}"
    </Message>
</Response>

SWML
Relay Realtime SDK (Server)
CXML
REST API

SWML

version: 1.0.0
sections:
  main:
    - send_sms:
        from_number: "+155512312345"
        to_number: "+15555554321"
        body: "Hello from SignalWire!"

📚 SWML docs View the full guide →

Relay Realtime SDK (Server)

import { SignalWire } from "@signalwire/realtime-api";

const client = await SignalWire({ project: "ProjectID Here", token: "Token Here"})

let messageClient = client.messaging;

const sendResult = await messageClient.send({
    from: "+155512312345",
    to: "+15555554321",
    body: "Hello from SignalWire!"
});

📚 RELAY docs View the full guide →

CXML

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Message>
        <Body>Hello from SignalWire!</Body>
    </Message>
</Response>

📚 CXML docs View the full guide →

REST API

curl -L 'https://<YOUR_SPACE>.signalwire.com/api/laml/2010-04-01/Accounts/<PROJECT_ID_HERE>/Messages' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-H 'Accept: application/json' \
-H 'Authorization: Basic <BASE64 ENCODED AUTHENTICATION STRING>' \
-d 'To=%2B155512312345' \
-d 'From=%2B15555554321' \
-d 'Body=Hello%20from%20SignalWire!'

📚 SignalWire API docs View the full guide →

SWML
Relay Realtime SDK (Server)
CXML
REST API

SWML

version: 1.0.0
sections:
  main:
    - send_sms:
        from_number: "+155512312345"
        to_number: "+15555554321"
        media: ["https://mcdn.signalwire.com/images/v2/loud/LogoLarge.jpg"]

Relay Realtime SDK (Server)

import { SignalWire } from "@signalwire/realtime-api";

const client = await SignalWire({ project: "ProjectID Here", token: "Token Here"})

let messageClient = client.messaging;

const sendResult = await messageClient.send({
    from: "+155512312345",
    to: "+15555554321",
    media: ["https://mcdn.signalwire.com/images/v2/loud/LogoLarge.jpg"]
});

CXML

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Message>
        <Body>Hello from SignalWire!</Body>
        <Media>https://mcdn.signalwire.com/images/v2/loud/LogoLarge.jpg</Media>
    </Message>
</Response>

REST API

curl -L 'https://<YOUR_SPACE>.signalwire.com/api/laml/2010-04-01/Accounts/<PROJECT_ID_HERE>/Messages' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-H 'Accept: application/json' \
-H 'Authorization: Basic <BASE64 ENCODED AUTHENTICATION STRING>' \
-d 'To=%2B155512312345' \
-d 'From=%2B15555554321' \
-d 'Media=https://mcdn.signalwire.com/images/v2/loud/LogoLarge.jpg'

Relay Realtime SDK (Server)
CXML

Relay Realtime SDK (Server)

import { SignalWire } from "@signalwire/realtime-api";

const client = await SignalWire({ project: "ProjectID Here", token: "Token Here"})

await client.messaging.listen({
  topics: ["office"],
  async onMessageReceived(message) {
    client.messaging.send({
        to: message.from,
        from: message.to,
        body: `The message ${message.body} has been received!`
    })
  }
})

CXML

<Response>
   <Message to={{From}} from={{To}}>The message {{Body}} has been received!</Message>
</Response>

Relay Realtime SDK (Server)
CXML

Relay Realtime SDK (Server)

import { SignalWire } from "@signalwire/realtime-api";

const client = await SignalWire({ project: "ProjectID Here", token: "Token Here"})

await client.messaging.listen({
  topics: ["office"],
  async onMessageReceived(message) {
    client.messaging.send({
        to: "+1xxxxxxxxxx",
        from: message.to,
        body: `
        You received a message from ${message.from} to SignalWire number ${message.to}.
        The message was: ${message.body}
        `
    })
  }
})

CXML

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Message to="+1xxxxxxxxxx">
        You received a message from: {{From}} to SignalWire number: {{To}}.
        The message is: "{{Body}}"
    </Message>
</Response>

SWML
Relay Realtime SDK (Server)
CXML
REST API

SWML

version: 1.0.0
sections:
  main:
    - send_sms:
        from_number: "+155512312345"
        to_number: "+15555554321"
        body: "Hello from SignalWire!"

📚 SWML docs View the full guide →

Relay Realtime SDK (Server)

import { SignalWire } from "@signalwire/realtime-api";

const client = await SignalWire({ project: "ProjectID Here", token: "Token Here"})

let messageClient = client.messaging;

const sendResult = await messageClient.send({
    from: "+155512312345",
    to: "+15555554321",
    body: "Hello from SignalWire!"
});

📚 RELAY docs View the full guide →

CXML

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Message>
        <Body>Hello from SignalWire!</Body>
    </Message>
</Response>

📚 CXML docs View the full guide →

REST API

curl -L 'https://<YOUR_SPACE>.signalwire.com/api/laml/2010-04-01/Accounts/<PROJECT_ID_HERE>/Messages' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-H 'Accept: application/json' \
-H 'Authorization: Basic <BASE64 ENCODED AUTHENTICATION STRING>' \
-d 'To=%2B155512312345' \
-d 'From=%2B15555554321' \
-d 'Body=Hello%20from%20SignalWire!'

📚 SignalWire API docs View the full guide →

SWML
Relay Realtime SDK (Server)
CXML
REST API

SWML

version: 1.0.0
sections:
  main:
    - send_sms:
        from_number: "+155512312345"
        to_number: "+15555554321"
        media: ["https://mcdn.signalwire.com/images/v2/loud/LogoLarge.jpg"]

Relay Realtime SDK (Server)

import { SignalWire } from "@signalwire/realtime-api";

const client = await SignalWire({ project: "ProjectID Here", token: "Token Here"})

let messageClient = client.messaging;

const sendResult = await messageClient.send({
    from: "+155512312345",
    to: "+15555554321",
    media: ["https://mcdn.signalwire.com/images/v2/loud/LogoLarge.jpg"]
});

CXML

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Message>
        <Body>Hello from SignalWire!</Body>
        <Media>https://mcdn.signalwire.com/images/v2/loud/LogoLarge.jpg</Media>
    </Message>
</Response>

REST API

curl -L 'https://<YOUR_SPACE>.signalwire.com/api/laml/2010-04-01/Accounts/<PROJECT_ID_HERE>/Messages' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-H 'Accept: application/json' \
-H 'Authorization: Basic <BASE64 ENCODED AUTHENTICATION STRING>' \
-d 'To=%2B155512312345' \
-d 'From=%2B15555554321' \
-d 'Media=https://mcdn.signalwire.com/images/v2/loud/LogoLarge.jpg'

Relay Realtime SDK (Server)
CXML

Relay Realtime SDK (Server)

import { SignalWire } from "@signalwire/realtime-api";

const client = await SignalWire({ project: "ProjectID Here", token: "Token Here"})

await client.messaging.listen({
  topics: ["office"],
  async onMessageReceived(message) {
    client.messaging.send({
        to: message.from,
        from: message.to,
        body: `The message ${message.body} has been received!`
    })
  }
})

CXML

<Response>
   <Message to={{From}} from={{To}}>The message {{Body}} has been received!</Message>
</Response>

Relay Realtime SDK (Server)
CXML

Relay Realtime SDK (Server)

import { SignalWire } from "@signalwire/realtime-api";

const client = await SignalWire({ project: "ProjectID Here", token: "Token Here"})

await client.messaging.listen({
  topics: ["office"],
  async onMessageReceived(message) {
    client.messaging.send({
        to: "+1xxxxxxxxxx",
        from: message.to,
        body: `
        You received a message from ${message.from} to SignalWire number ${message.to}.
        The message was: ${message.body}
        `
    })
  }
})

CXML

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Message to="+1xxxxxxxxxx">
        You received a message from: {{From}} to SignalWire number: {{To}}.
        The message is: "{{Body}}"
    </Message>
</Response>

Choose an API

SignalWire's many API offerings make it quick and easy to send and receive SMS and MMS within an application through a variety of phone number types. There are a few different ways to utilize these services, so we encourage you to browse the documentation for our APIs.

💬looking for Chat or PubSub?

SignalWire's Messaging APIs are tailored for SMS and MMS over the PSTN. For non-PSTN applications, check out our Chat APIs.

Compatibility APIs

Easy migration from other providers in our industry with a notoriously higher billio.

Realtime Server SDK

Build a messaging solution with your own server using web socket technology for low latency operations.

REST APIs

Use classic HTTP calls to manage brands and campaigns, configure phone numbers, and much more.

What Kind of Guide are you Looking for?

Send your first SMS

Focused on installation, authentication, and the most basic examples of SMS Messaging. You will also find all of the vital information on The Campaign Registry in this section.

Guides

Guides on general information and common use cases. General guides apply to all products while CXML API and Realtime API guides are separated by the API product.

Examples

Full walkthroughs of more specific use cases with either a dedicated GitHub repo or extensive embedded code examples.

Popular Guides

Forward your Texts to Email

Learn how to listen for incoming text messages (SMS) and forward them to an email address.

Create a Private URL Shortener

Learn how to build an a private URL shortener.

Send SMS from the Browser

This guide shows you how to create a web application that allows users to send SMS from the browser.

Try it out​

SWML

Relay Realtime SDK (Server)

CXML

REST API

Choose an API​

What Kind of Guide are you Looking for?​

Popular Guides​

Try it out

Choose an API

What Kind of Guide are you Looking for?

Popular Guides