PHPackages                             messagemedia/webhooks-sdk - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. messagemedia/webhooks-sdk

ActiveLibrary[API Development](/categories/api)

messagemedia/webhooks-sdk
=========================

The MessageMedia Webhooks allows you to subscribe to one or several events and when one of those events is triggered, an HTTP request is sent to the URL of your choice along with the message or payload. In simpler terms, it allows applications to 'speak' to one another and get notified automatically when something new happens.

1.0.0(7y ago)31.7k[5 issues](https://github.com/messagemedia/webhooks-php-sdk/issues)Apache-2.0PHPPHP >=5.4.0

Since Jun 26Pushed 7y ago4 watchersCompare

[ Source](https://github.com/messagemedia/webhooks-php-sdk)[ Packagist](https://packagist.org/packages/messagemedia/webhooks-sdk)[ Docs](https://developers.messagemedia.com)[ RSS](/packages/messagemedia-webhooks-sdk/feed)WikiDiscussions master Synced 2mo ago

READMEChangelog (1)Dependencies (4)Versions (2)Used By (0)

MessageMedia Webhooks PHP SDK
=============================

[](#messagemedia-webhooks-php-sdk)

[![Travis Build Status](https://camo.githubusercontent.com/9d6104d1596ec4b90abad3710226d0d7b45a65e6d77b9c88b9f071576bf27bc8/68747470733a2f2f6170692e7472617669732d63692e6f72672f6d6573736167656d656469612f776562686f6f6b732d7068702d73646b2e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/messagemedia/webhooks-php-sdk)[![Pull Requests Welcome](https://camo.githubusercontent.com/7d9ed3c8f22eceb1711573169b1390cc0b1194467340dc815205060c162b5309/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5052732d77656c636f6d652d627269676874677265656e2e7376673f7374796c653d666c6174)](http://makeapullrequest.com)[![PHP version](https://camo.githubusercontent.com/ec6ccfb6671041b73b76d0cf91b8f08814c38bacef0ea44b24be9f593576267a/68747470733a2f2f62616467652e667572792e696f2f70682f6d6573736167656d65646961253246776562686f6f6b732d73646b2e737667)](https://badge.fury.io/ph/messagemedia%2Fwebhooks-sdk)

The MessageMedia Webhooks allows you to subscribe to one or several events and when one of those events is triggered, an HTTP request is sent to the URL of your choice along with the message or payload. In simpler terms, it allows applications to "speak" to one another and get notified automatically when something new happens.

[![Webhooks Flow](https://camo.githubusercontent.com/9b7e3d820719c982f5998f3abfe4ed5e35f3563f41faf75dfae104fe7fff0a65/687474703a2f2f6936362e74696e797069632e636f6d2f327566786638312e6a7067)](https://camo.githubusercontent.com/9b7e3d820719c982f5998f3abfe4ed5e35f3563f41faf75dfae104fe7fff0a65/687474703a2f2f6936362e74696e797069632e636f6d2f327566786638312e6a7067)

Table of Contents
-----------------

[](#table-of-contents)

- [Authentication](#closed_lock_with_key-authentication)
- [Errors](#interrobang-errors)
- [Information](#newspaper-information)
    - [Slack and Mailing List](#slack-and-mailing-list)
    - [Bug Reports](#bug-reports)
    - [Contributing](#contributing)
- [Installation](#star-installation)
- [Get Started](#clapper-get-started)
- [API Documentation](#closed_book-api-documentation)
- [Need help?](#confused-need-help)
- [License](#page_with_curl-license)

🔐 Authentication
----------------

[](#closed_lock_with_key-authentication)

Authentication is done via API keys. Sign up at  to get your API keys.

Requests are authenticated using HTTP Basic Auth or HMAC. Provide your API key as the auth\_user\_name and API secret as the auth\_password.

⁉️ Errors
---------

[](#interrobang-errors)

Our API returns standard HTTP success or error status codes. For errors, we will also include extra information about what went wrong encoded in the response as JSON. The most common status codes are listed below.

#### HTTP Status Codes

[](#http-status-codes)

CodeTitleDescription400Invalid RequestThe request was invalid401UnauthorizedYour API credentials are invalid403Disabled featureFeature not enabled404Not FoundThe resource does not exist50XInternal Server ErrorAn error occurred with our API📰 Information
-------------

[](#newspaper-information)

#### Slack and Mailing List

[](#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

[](#bug-reports)

If you discover a problem with the SDK, we would like to know about it. You can raise an [issue](https://github.com/messagemedia/signingkeys-nodejs-sdk/issues) or send an email to:

#### Contributing

[](#contributing)

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](https://github.com/messagemedia/signingkeys-nodejs-sdk/issues)

⭐ Installation
--------------

[](#star-installation)

Run the Composer command to install the latest stable version of the Messages SDK:

```
composer require messagemedia/webhooks-sdk

```

🎬 Get Started
-------------

[](#clapper-get-started)

It's easy to get started. Simply enter the API Key and secret you obtained from the [MessageMedia Developers Portal](https://developers.messagemedia.com) into the code snippet below.

### Create a webhook

[](#create-a-webhook)

```