Programmable SMS

How to integrate with our Channels API for SMS/MMS Messaging

Summary

SMS (Short Message Service) is a messaging channel that allows businesses to communicate with customers through text messages on their mobile devices. With SMS, businesses can quickly and easily reach a large number of customers and automate their communication processes.

In addition in the United States and Canada it is also possible to send media messages through MMS (Multimedia Message Service).

Installation

To send SMS messages you will need an SMS capable number and this will need to be installed as an SMS channel. If the number is also MMS capable you will also be able to send media messages though the channel.

Checking if a channel is MMS capable

You can validate if a channel is MMS capable by the capabilities object that is returned in the GET channel request

Get channel

Retrieve a specific workspace channel

GET/workspaces/{workspaceId}/channels/{channelId}

Authorization

useraccessKey

Path parameters

workspaceId*string (uuid)

The ID of the workspace

channelId*string (uuid)

The ID for a channel

Response

200404

OK

Body

application/json

id*string (uuid)

platformId*string

Pattern: ^[A-Za-z0-9-]+$

name*string

connectorId*string (uuid)

identifierstring

status*enum

activependingsetting-upfailedinactivedeletedwarning

contactIdentifierKeyOverridenullable string

Pattern: ^[A-Za-z0-9_-]+$

contactIdentifierFormatOverridenullable object

platformServiceUrlOverridenullable string

Pattern: ^https://

platformServiceVersionOverridenullable enum

1.0

platformServiceProtocolOverridenullable enum

httphttps

platformMessageJsonSchemaOverridenullable object

platformTemplateEngineOverridenullable enum

defaultliquid

capabilitiesobject

settingsarray of object

connectionParamsarray of object

preferencesnullable object

useCaseIdnullable string

useCaseTypenullable enum

transactionalmarketingconversation

channelMessageTypeenum

promotional2faconversationaltransactionalemergency

suitesarray of enum

createdAt*string (date-time)

updatedAtstring (date-time)

Request

JavaScriptCurlPythonHTTP

const response = await fetch('/workspaces/{workspaceId}/channels/{channelId}', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer jwt"
    },
});
const data = await response.json();

Response

200404

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "platformId": "text",
  "name": "text",
  "connectorId": "123e4567-e89b-12d3-a456-426614174000",
  "identifier": "text",
  "status": "active",
  "contactIdentifierKeyOverride": "text",
  "contactIdentifierFormatOverride": {
    "type": "none",
    "pattern": "text"
  },
  "platformServiceUrlOverride": "text",
  "platformServiceVersionOverride": "1.0",
  "platformServiceProtocolOverride": "http",
  "platformTemplateEngineOverride": "default",
  "capabilities": {
    "messaging": {
      "messaging": {
        "displayName": "text",
        "status": "text",
        "name": "text",
        "version": 0,
        "updatedAt": "2025-01-30T14:46:39.510Z",
        "createdAt": "2025-01-30T14:46:39.510Z",
        "expiresAt": "2025-01-30T14:46:39.510Z",
        "outgoing": {
          "displayName": "text",
          "status": "text",
          "name": "text",
          "version": 0,
          "updatedAt": "2025-01-30T14:46:39.510Z",
          "createdAt": "2025-01-30T14:46:39.510Z",
          "expiresAt": "2025-01-30T14:46:39.510Z",
          "mms": {
            "displayName": "text",
            "status": "text",
            "name": "text",
            "version": 0,
            "paused": false,
            "updatedAt": "2025-01-30T14:46:39.510Z",
            "createdAt": "2025-01-30T14:46:39.510Z",
            "expiresAt": "2025-01-30T14:46:39.510Z"
          },
          "media": {
            "textFallback": {
              "displayName": "text",
              "status": "text",
              "name": "text",
              "version": 0,
              "paused": false,
              "updatedAt": "2025-01-30T14:46:39.510Z",
              "createdAt": "2025-01-30T14:46:39.510Z",
              "expiresAt": "2025-01-30T14:46:39.510Z"
            }
          }
        },
        "incoming": {
          "displayName": "text",
          "status": "text",
          "name": "text",
          "version": 0,
          "updatedAt": "2025-01-30T14:46:39.510Z",
          "createdAt": "2025-01-30T14:46:39.510Z",
          "expiresAt": "2025-01-30T14:46:39.510Z",
          "mms": {
            "displayName": "text",
            "status": "text",
            "name": "text",
            "version": 0,
            "paused": false,
            "updatedAt": "2025-01-30T14:46:39.510Z",
            "createdAt": "2025-01-30T14:46:39.510Z",
            "expiresAt": "2025-01-30T14:46:39.510Z"
          }
        }
      }
    },
    "voice": {
      "voice": {
        "displayName": "text",
        "status": "text",
        "name": "text",
        "version": 0,
        "updatedAt": "2025-01-30T14:46:39.510Z",
        "createdAt": "2025-01-30T14:46:39.510Z",
        "expiresAt": "2025-01-30T14:46:39.510Z",
        "recording": {
          "displayName": "text",
          "status": "text",
          "name": "text",
          "version": 0,
          "paused": false,
          "updatedAt": "2025-01-30T14:46:39.510Z",
          "createdAt": "2025-01-30T14:46:39.510Z",
          "expiresAt": "2025-01-30T14:46:39.510Z"
        }
      }
    }
  },
  "settings": [
    {
      "key": "text",
      "value": "text",
      "displayName": "text",
      "description": "text",
      "visibility": "public"
    }
  ],
  "connectionParams": [
    {
      "key": "text",
      "value": "text",
      "displayName": "text",
      "description": "text",
      "visibility": "public"
    }
  ],
  "preferences": {
    "disableProfileFetching": false,
    "explicitMarketingOptOut": false,
    "ignoreSuppressionChecks": false,
    "isPrivate": false
  },
  "useCaseId": "text",
  "useCaseType": "transactional",
  "channelMessageType": "promotional",
  "suites": [
    "marketing"
  ],
  "createdAt": "2025-01-30T14:46:39.510Z",
  "updatedAt": "2025-01-30T14:46:39.510Z"
}

If the channel is MMS capable, the following capabilities will show as active (otherwise inactive)

• capabilities.messaging.outgoing.mms.status = active

• capabilities.messaging.inbound.mms.status = active