--- title: How to configure webhooks with the smsmode© API description: How to configure webhooks with the smsmode© API. Receiving responses & statuses via webhooks with the smsmode API --- [Skip to content](https://support.smsmode.com/en/base-de-connaissance/réception-webhooks-api-smsmode#main-content) - [English](https://support.smsmode.com/en/base-de-connaissance/r%C3%A9ception-webhooks-api-smsmode) - [Français](https://support.smsmode.com/fr/base-de-connaissance/réception-webhooks-api-smsmode) English Show submenu for translations [More support](https://support.smsmode.com/en/base-de-connaissance/kb-tickets/new?hsLang=en) [Customer portal](https://ticket.smsmode.com/tickets-view?hsLang=en) [![logo-smsmode-2019-long 1-2.png\]](https://support.smsmode.com/hs-fs/hubfs/logo-smsmode-2019-long%201-2.png?width=140&height=38&name=logo-smsmode-2019-long%201-2.png)](https://support.smsmode.com/en/base-de-connaissance?hsLang=en) - [API documentation](https://dev.smsmode.com/) - [My tickets](https://ticket.smsmode.com/tickets-view?offset=0) - [Log out](https://26532669.hs-sites-eu1.com/_hcms/mem/logout) Open main navigation Close main navigation - [API documentation](https://dev.smsmode.com/) - [My tickets](https://ticket.smsmode.com/tickets-view?offset=0) - [Log out](https://26532669.hs-sites-eu1.com/_hcms/mem/logout) - - [English](https://support.smsmode.com/en/base-de-connaissance/r%C3%A9ception-webhooks-api-smsmode) - [Français](https://support.smsmode.com/fr/base-de-connaissance/réception-webhooks-api-smsmode) English Show submenu for translations - [More support](https://support.smsmode.com/en/base-de-connaissance/kb-tickets/new) - [Customer portal](https://ticket.smsmode.com/tickets-view) - [smsmode.com](https://www.smsmode.com/en/) [smsmode.com](https://www.smsmode.com/en/) Hello! How can we help you today? - There are no suggestions because the search field is empty. 1. [Portail support et base de connaissance - smsmode](https://support.smsmode.com/en/base-de-connaissance?hsLang=en) 2. [Integrations, Plug-ins and APIs](https://support.smsmode.com/en/base-de-connaissance/integrations-plug-ins-and-apis?hsLang=en) 3. [API REST](https://support.smsmode.com/en/base-de-connaissance/integrations-plug-ins-and-apis?hsLang=en#api-rest) # How to configure webhooks with the smsmode© API ## Receiving responses & statuses via webhooks with the smsmode API When using the smsmode© SMS API to send SMS messages, it is often useful to automatically receive replies from recipients (incoming SMS messages) or to be notified in real time of a message's delivery status (‘delivery confirmation’). **This is where webhooks come in**: they allow you to receive automated HTTP calls to an endpoint of your choice as soon as an SMS-related event occurs. ### Typical events you may want to capture include: - receipt of an incoming SMS (MO – ‘Mobile Originated’) to a number or alias you have configured; - delivery status (DLR – ‘Delivery Receipt’) for a message sent via the API: delivered, failed, in progress; possibly, clicks on a short link or unsubscription (‘STOP’) if you use additional features.   ### Why is this important? - You can move towards a real conversation: when a customer replies to your SMS, you can take their reply into account (e.g. ‘Yes’, “STOP”, ‘1’). - You improve service quality: by receiving statuses, you can detect delivery failures and resend or track. - You automate your workflows: for example, trigger an alert in your CRM or ticketing tool when a ‘STOP’ response arrives. - You ensure compliance and deliverability: knowing when an SMS is rejected or blocked helps you monitor your campaigns. ### How do you set up a webhook? #### a) Create/activate your endpoint - On your server/application, define a secure public URL (HTTPS) capable of receiving POST requests. - Ensure that it can process JSON (or another) format and respond quickly (often \< 300 ms) to avoid timeouts. #### b) Configure in smsmode© (or via the API) - In your smsmode© space or via the corresponding API key, specify this URL as the ‘receiving webhook’ or ‘status callback’. - Choose the events to activate (responses, statuses, etc.). - Check that your URL is accessible from outside (no firewall blocking). #### c) Best practices for processing - Check the event to find out the type of notification. - Save the data in your database (message\_id, recipient, status, text) for traceability. - Respond quickly with an HTTP 200 code if your process has successfully received the webhook, to prevent it from being sent again. - Manage any retransmissions (e.g. a webhook sent twice). - Secure your endpoint: authentication (token, authorised IPs, etc.).   ### 4. Concrete use cases - Automatic retry: If a message is returned as ‘failed’, trigger an internal alert or a new sending attempt. - Automatic unsubscription: If the text received is ‘STOP’, mark the contact as unsubscribed and do not send any more marketing SMS messages. - Real-time deliverability statistics: Record all ‘delivered’ vs. ‘undelivered’ statuses to trigger reports. - Interactive conversation: When a customer replies ‘YES’, trigger a workflow (e.g. sending a link, assigning an advisor, etc.).   Please note: SMS replies are only possible from a short code (e.g. 36954). You cannot receive replies if your SMS is sent with a custom sender ID.  ### 5. Checks & recommendations   - Check that you have sufficient API quota or credits before sending (to avoid ‘failed’ messages). - If you use a sender ID (custom sender), check that it complies with legislation (France/EU). Ensure that your webhooks are highly available and that you handle errors (5xx returns, timeouts). - Keep a history of events for audits (e.g. a recipient replied but was not taken into account). - Be aware of delays: there may be a few seconds/minutes of latency in delivery or return.   - [Product and Channels](https://support.smsmode.com/en/base-de-connaissance/product-and-channels?hsLang=en#main-content) - [RCS](https://support.smsmode.com/en/base-de-connaissance/product-and-channels?hsLang=en#rcs) - [Setup and Installation](https://support.smsmode.com/en/base-de-connaissance/setup-and-installation?hsLang=en#main-content) - [Fees and payment methods](https://support.smsmode.com/en/base-de-connaissance/setup-and-installation?hsLang=en#fees-and-payment-methods) - [Contact management](https://support.smsmode.com/en/base-de-connaissance/setup-and-installation?hsLang=en#contact-management) - [Message sending management](https://support.smsmode.com/en/base-de-connaissance/setup-and-installation?hsLang=en#message-sending-management) - [My Account](https://support.smsmode.com/en/base-de-connaissance/setup-and-installation?hsLang=en#my-account) - [Security Measures](https://support.smsmode.com/en/base-de-connaissance/setup-and-installation?hsLang=en#security-measures) - [Basic Functionalities](https://support.smsmode.com/en/base-de-connaissance/basic-functionalities?hsLang=en#main-content) - [Contacts Management](https://support.smsmode.com/en/base-de-connaissance/basic-functionalities?hsLang=en#contacts-management) - [Response Management](https://support.smsmode.com/en/base-de-connaissance/basic-functionalities?hsLang=en#response-management) - [Campaign Management](https://support.smsmode.com/en/base-de-connaissance/basic-functionalities?hsLang=en#campaign-management) - [Security](https://support.smsmode.com/en/base-de-connaissance/basic-functionalities?hsLang=en#security) - [Different Uses](https://support.smsmode.com/en/base-de-connaissance/basic-functionalities?hsLang=en#different-uses) - [Security Parameters](https://support.smsmode.com/en/base-de-connaissance/basic-functionalities?hsLang=en#security-parameters) - [content](https://support.smsmode.com/en/base-de-connaissance/basic-functionalities?hsLang=en#content) - [Advanced functionalities](https://support.smsmode.com/en/base-de-connaissance/advanced-functionalities?hsLang=en#main-content) - [Automations](https://support.smsmode.com/en/base-de-connaissance/advanced-functionalities?hsLang=en#automations) - [Troubleshooting and Problem Solving](https://support.smsmode.com/en/base-de-connaissance/troubleshooting-and-problem-solving?hsLang=en#main-content) - [Error Codes](https://support.smsmode.com/en/base-de-connaissance/troubleshooting-and-problem-solving?hsLang=en#error-codes) - [Integrations, Plug-ins and APIs](https://support.smsmode.com/en/base-de-connaissance/integrations-plug-ins-and-apis?hsLang=en#main-content) - [Integration with other services](https://support.smsmode.com/en/base-de-connaissance/integrations-plug-ins-and-apis?hsLang=en#integration-with-other-services) - [Protocols](https://support.smsmode.com/en/base-de-connaissance/integrations-plug-ins-and-apis?hsLang=en#protocols) - [API REST](https://support.smsmode.com/en/base-de-connaissance/integrations-plug-ins-and-apis?hsLang=en#api-rest) - [SMPP](https://support.smsmode.com/en/base-de-connaissance/integrations-plug-ins-and-apis?hsLang=en#smpp) - [Technical Support](https://support.smsmode.com/en/base-de-connaissance/technical-support?hsLang=en#main-content) - [How to request assistance](https://support.smsmode.com/en/base-de-connaissance/technical-support?hsLang=en#how-to-request-assistance) - [FAQs and Tips](https://support.smsmode.com/en/base-de-connaissance/faqs-and-tips?hsLang=en#main-content) - [Our Rates](https://support.smsmode.com/en/base-de-connaissance/faqs-and-tips?hsLang=en#our-rates) - [Test the Platform](https://support.smsmode.com/en/base-de-connaissance/faqs-and-tips?hsLang=en#test-the-platform) - [Contacts Management](https://support.smsmode.com/en/base-de-connaissance/faqs-and-tips?hsLang=en#contacts-management) - [Response Management](https://support.smsmode.com/en/base-de-connaissance/faqs-and-tips?hsLang=en#response-management) - [Uses of the Platform](https://support.smsmode.com/en/base-de-connaissance/faqs-and-tips?hsLang=en#uses-of-the-platform) - [Tips and tricks](https://support.smsmode.com/en/base-de-connaissance/faqs-and-tips?hsLang=en#tips-and-tricks) - [Billing](https://support.smsmode.com/en/base-de-connaissance/billing?hsLang=en) - [Safety measures](https://support.smsmode.com/en/base-de-connaissance/safety-measures?hsLang=en) [![Chill listening crop-3](https://support.smsmode.com/hs-fs/hubfs/Imported%20images/smsmode-logo-769x172%20(2).png?width=107&height=24&name=smsmode-logo-769x172%20(2).png "Chill listening crop-3")](https://www.smsmode.com/) Help center www.smsmode.com Copyright © 2026, smsmode©