MessageBird is an SMS marketing, notification and communication service that allows users to send and receive personalized text messages.


MessageBird SMS supports a wide variety of capabilities as seen in the channel capabilities grid. Below is a detailed view of each capabilities.

Content Types

  • Text

    Full SupportAPI
  • Image

    Full SupportAPI
  • File

    Full SupportAPI
  • Emoji

    Full SupportAPI
  • GIF

    Full SupportAPI
  • Location

    Partial SupportAPI

Action Types

  • Link

    Full SupportAPI
  • Extension

    Partial SupportAPI
  • Buy

    Full SupportAPI
  • Postback

    Partial SupportAPI
  • Reply

    Full SupportAPI
  • Location Request

    Partial SupportAPI

Structured Messages

  • Compound Message

    Partial SupportAPI
  • Carousel

    Partial SupportAPI

Delivery Events

Delivery events allow you to track deliveries of Smooch messages to MessageBird by subscribing to the message:delivery:channel webhook. Smooch also tracks user deliveries on MessageBird which let you confirm whether a message has reached the user by listening to the message:delivery:user webhook. Failures to deliver a message to MessageBird or to a MessageBird user can be detected by subscribing to the message:delivery:failure webhook.

The MessageBird message IDs associated with each Smooch message are available in delivery event payloads in the externalMessages property.

Configuring MessageBird

Add the MessageBird integration through the Smooch dashboard or via the REST API.

Smooch MessageBird Dashboard Integration

After the integration, you will be provided with a Smooch webhook URL. First, you will need to create a MessageBird flow. Go to your MessageBird Flow builder, use the flow “Call HTTP endpoint with SMS” and give it a name.

MessageBird Flow Builder Call HTTP endpoint with SMS

On the next page, select the desired number on the right of the screen under “Incoming SMS” and click “Save”.

MessageBird Flow Builder Incoming SMS

Then, click on the “Forward to URL” bubble and select the method “POST”. In the URL field, you will need to provide the Smooch webhook URL provided by the Smooch dashboard. If you used the REST API to create the integration, you will need to use the webhookSecret from the response to write the following with the respective values to your integration:{appId}/{integrationId}/{webhookSecret}.

Select “application/json” for the “Set Content-Type header” field.

Click “Save”, then “Publish changes” on the upper right corner.

Messagebird Flow Builder Forward URL

If you integrated MessageBird via the Smooch dashboard, confirm your integration.

Smooch MessageBird Dashboard Integration Confirm