Verify the authenticity of your webhooks
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

MessageMedia Enterprise WebHooks Python Code Guide

Pull Requests Welcome

The MessageMedia Enterprise WebHooks code guide demonstrates how you can verify WebHooks signed and sent to you by MessageMedia.


Table of Contents

📰 Information

Slack and Mailing List

If you have any questions, comments, or concerns, please join our Slack channel:

Alternatively you can email us at:

Bug reports

If you discover a problem with the code guide, we would like to know about it. You can raise an issue or send an email to:


We welcome your thoughts on how we could best provide you with SDKs that would simplify how you consume our services in your application. You can fork and create pull requests for any features you would like to see or raise an issue

⭐️ Prerequisite

To be able to use this SDK, you will need a public key provided by MessageMedia. You can find out how to do this by going through the Signature Key Management documentation. You can then make use of the Signature Key Management Python SDK to create and manage your keys.

This SDK assumes that you have pre-configured a WebHook that sends data to a url. If you haven't done this, you can read about how to set one up in the WebHooks API Documentation or the WebHooks Python SDK. Alternatively, you can specify a callback_url in the message body of a send message request.

🎬 Get Started

To keep this guide simple and easy to understand, we've used BaseHTTPServer to set up a server which will monitor for incoming WebHooks. You can setup your own production server and use it instead of the BaseHTTPServer one if needed.

Initialisation and Installation

Create an empty directory for your project, let’s name it “testApp”. Now, open up your command prompt and clone this repository into the directory created.

Adding in the public key

Create a file for your public key and set the PUB_KEY_PATH to the path for the file containing your public key.


You are now ready to test the application. Run the web server on your computer that has PHP installed and configured. If all goes well, you should receive a JSON response with an object that contains a verified property. This property indicates if the verification was a success.

📕 API Reference Documentation

Check out the full API documentation for more detailed information.

😕 Need help?

Please contact developer support at or check out the developer portal at

📃 License

Apache License. See the LICENSE file.