Setting up Webhooks

Learn how to set up webhooks with the Mobile Text Alerts API

With Mobile Text Alerts webhooks you can receive real time notifications of events, such as: sent messages, message replies, and delivery statuses. With the Mobile Text Alerts Webhooks API endpoints you can register, delete, and view the webhooks on your account.

Webhooks Overview

Webhooks are a way for applications to communicate with each other, with real-time data sent from one application to another whenever a given event occurs. For events you want to be notified of, you can configure a webhook to your specified URL.

Mobile Text Alerts does not enforce verification of your endpoint listener — it sends the X-Signature header on every request, but your endpoint can respond 200 without checking it. This makes client-side enforcement a developer responsibility. See Webhook Signature Verification to learn more.

For example, when a user replies to a message that was sent; Mobile Text Alerts receives the inbound message from a provider and will post the inbound message to your provided endpoint.

Event Types

The Mobile Text Alerts API supports the following event types for webhooks:

Message Reply message-reply

When Mobile Text Alerts receives an inbound message from a provider, Mobile Text Alerts will post the inbound message to the customer provided endpoint.

• Message Reply payload

Delivery Status delivery-status

When Mobile Text Alerts receives an updated delivery status from a provider regarding a customer's sent message.

• Delivery Status payload

Message Send message-send

When Mobile Text Alerts sends a message to a provider, Mobile Text Alerts will post the message to the customer-provided endpoint.

• Message Send payload

Number Opt-In number-opt-in

You must receive an inbound opt-in message before you send outbound iMessages and RCS messages. This webhook will post the opt-in event to the customer provided endpoint.

• Number Opt-In payload

Webhook Failure Email Alerts

When registering a webhook, you can choose to receive emails if Mobile Text Alerts fails to send a request to your configured URL or a non-200 response code was received. To receive these email alerts: when registering a webhook, set sendAlertEmail to true , with alertEmail set to the intended email address.

Next Steps: Create your first webhook

Visit Setting up your first webhook to learn how to set up your first webhook

To learn more about Mobile Text Alerts webhooks, check out these other resources below:

View the webhook event payloads for Mobile Text Alerts:

Webhooks

Learn how to configure verification for your webhook listener endpoint:

Webhook Signature Verification

View the Webhooks API Reference:

Webhooks