--- title: REST API parameter notifyUrl description: SMS Global Knowledgebase --- [![](https://cdn.craft.cloud/ff00d28e-6061-427e-b58d-8267ebeaad6b/builds/a173c27c-7ed2-40a3-b553-3262aea64d9e/artifacts/dist/img/logo/sms-global-logo.svg)](https://smsglobal.com?hsLang=en-au) smsglobal.com [Talk to an expert](https://www.smsglobal.com/contact?hsLang=en-au) Talk to an expert [Skip to content](https://knowledgebase.smsglobal.com/rest-api-parameter-notifyurl-smsglobal-help-center#main-content) [![SMSGLOBAL LOGO WHITE-2](https://knowledgebase.smsglobal.com/hs-fs/hubfs/SMSGLOBAL%20LOGO%20WHITE-2.png?width=500&height=100&name=SMSGLOBAL%20LOGO%20WHITE-2.png)](https://www.smsglobal.com/?hsLang=en-au) Open main navigation Close main navigation - [Contact us](https://www.smsglobal.com/contact/) [Contact us](https://www.smsglobal.com/contact/?hsLang=en-au) Advice and answers from the SMSGlobal Team - There are no suggestions because the search field is empty. 1. [SMS Global Knowledgebase](https://knowledgebase.smsglobal.com/?hsLang=en-au) 2. [Delivery Receipts](https://knowledgebase.smsglobal.com/delivery-receipts?hsLang=en-au) # REST API parameter notifyUrl ## Information on notifyUrl vs DLR (Delivery Receipts) Parameter **notifyUrl** is specific to [REST API](https://www.smsglobal.com/rest-api/?hsLang=en-au) and is used to send updates of message statuses. It takes a URL as an input, and SMSGlobal posts back the message statuses to this URL. This was designed for bulk SMS sending via REST API and returning status updates to customer servers, applications, etc. ***Note:*** notifyUrl SMS status updates are separate to [Delivery Receipts (DLRs)](https://hs.smsglobal.com/delivery-receipts-smsglobal-help-center?hsLang=en-au). As a prerequisite to use notifyUrl, you must also enable DLR postback in [MXT settings](https://mxt.smsglobal.com/integrations/delivery-receipt). Simply switch on the toggle to enable. SMSGlobal systems will check for notifyUrl during processing, and if used, we will send the DLR to notifyURL instead. notifyURL will always take precedence if used and override MXT delivery receipt settings. notifyUrl postback can be received in JSON and XML format also. [![](https://knowledgebase.smsglobal.com/hubfs/Knowledge%20Base%20Import/DLR_RESTAPI_notifrUrl.gif)](https://downloads.intercomcdn.com/i/o/357380540/8fd6d79bc8bb983aa4a87741/DLR_RESTAPI_notifrUrl.gif?expires=1768789800&signature=38365882f22e1606d3c0cca817f79efd263ea26239b70515298c89c9c05c8ed2&req=dyUgFcF%2BmIVfFb4f3HP0gBwfz3xRC8Wbrf4szfwB84b%2F27MQeCyR6NtvPkjL%0AsChncLAoRlfkn3TmWQ%3D%3D%0A) See below a list of parameters that are sent with each notifyUrl: | Field | Meaning | | --- | --- | | id | Message part identifier | | status | Current [status](https://knowledgebase.smsglobal.com/en/articles/5178516-what-does-my-message-status-mean?hsLang=en-au)of the SMS message | | update\_time | The date in UTC when the message status was updated | | outgoing\_id | Outgoing message identifier | Below are sample values received: ``` id 9856866448480992outgoing_id 5231184863status Deliveredupdate_time 2020-08-07T13%3A17%3A14%2B10%3A00 ```   For further information, please view our [REST API Documentation](http://smsglobal.com/rest-api/?hsLang=en-au).   - [Sending a SMS](https://knowledgebase.smsglobal.com/sending-a-sms?hsLang=en-au) - [Sender ID](https://knowledgebase.smsglobal.com/sender-id?hsLang=en-au) - [API and Integration](https://knowledgebase.smsglobal.com/api-and-integration?hsLang=en-au) - [Email to SMS](https://knowledgebase.smsglobal.com/email-to-sms?hsLang=en-au) - [Reporting](https://knowledgebase.smsglobal.com/reporting?hsLang=en-au) - [Sub-Accounts](https://knowledgebase.smsglobal.com/sub-accounts?hsLang=en-au) - [Delivery Receipts](https://knowledgebase.smsglobal.com/delivery-receipts?hsLang=en-au) - [Billing and Payments](https://knowledgebase.smsglobal.com/billing-and-payments?hsLang=en-au) - [Contact Lists](https://knowledgebase.smsglobal.com/contact-lists?hsLang=en-au) - [Managing Opt-Outs](https://knowledgebase.smsglobal.com/managing-opt-outs?hsLang=en-au) - [Campaigns](https://knowledgebase.smsglobal.com/campaigns?hsLang=en-au) - [Templates](https://knowledgebase.smsglobal.com/templates?hsLang=en-au) - [MMS](https://knowledgebase.smsglobal.com/mms?hsLang=en-au) - [Voice](https://knowledgebase.smsglobal.com/voice?hsLang=en-au) - [Laws and Regulations](https://knowledgebase.smsglobal.com/laws-and-regulations?hsLang=en-au) - [Video Tutorials](https://knowledgebase.smsglobal.com/video-tutorials?hsLang=en-au) - [Account Settings](https://knowledgebase.smsglobal.com/account-settings?hsLang=en-au) - [Understanding Unicode Messages](https://knowledgebase.smsglobal.com/understanding-unicode-messages?hsLang=en-au) [![SMSGlobal](https://knowledgebase.smsglobal.com/hs-fs/hubfs/SMSGlobal-logo-black-transp.png?width=200&height=56&name=SMSGlobal-logo-black-transp.png "SMSGlobal")](http://smsglobal.com?hsLang=en-au) [mailto:support@email.com](mailto:support@email.com) Copyright © 2026, SMSGlobal ![](https://analytics.twitter.com/i/adsct?txn_id=nxnc4&p_id=Twitter&tw_sale_amount=0&tw_order_quantity=0) ![](https://t.co/i/adsct?txn_id=nxnc4&p_id=Twitter&tw_sale_amount=0&tw_order_quantity=0) [![SMSGlobal](https://cdn.craft.cloud/ff00d28e-6061-427e-b58d-8267ebeaad6b/builds/a173c27c-7ed2-40a3-b553-3262aea64d9e/artifacts/dist/img/logo/sms-global-logo-light.svg)](https://smsglobal.com/?hsLang=en-au) © Copyright . SMSGlobal. All rights reserved. [smsglobal.com](https://smsglobal.com/?hsLang=en-au) [Talk to an expert](https://smsglobal.com/contact/?hsLang=en-au)