This article explains how to use the webhooks user interface.

Webhooks are a tool that allows Emma to send information to, or receive information from, an external application when a certain action occurs in Emma. For example, when a contact fills out your signup form, the member_signup webhook will send information to a destination that you specify.

In this article Where to find the webhooks user interface How to create a webhook through the user interface How to edit or delete a webhook through the user interface How to test a webhook Additional resources

Where to find the webhooks user interface

Ⓘ	Only the account Parent, Managers, and Administrators can access the webhooks UI.

The webhooks UI is located in an account's or subaccount's settings. Follow the steps below to access it:

1. Navigate to the appropriate subaccount, if applicable.
2. Click on the gear icon in the upper right corner.
3. Choose Webhooks from the dropdown menu.

How to create a webhook through the user interface

To create a webhook, simply click on the Create webhook button and fill out the information in the pop-up window that appears. You will need to enter:

• Webhook URL - This is the external source that Emma will talk to when the event happens
• Event type - This is the event that will trigger the webhook to act
• Method - This is either POST or GET. POST sends information, GET retrieves information

Once you've filled in all of the required information, click on the Create button to complete the setup.

How to edit or delete a webhook through the user interface

To edit or delete a webhook, simply click on the dropdown arrow that corresponds to the webhook in question. To delete the webhook, choose Delete from the dropdown menu. To edit the webhook, choose Edit from the dropdown menu.

How to test a webhook

You can use requestcatcher.com to easily test your webhooks by following these steps:

1. Navigate to requestcatcher.com.

2. On the right side of the page, you should a partial URL with a blank space in the middle. In that blank space, type something to create a unique URL.

   

3. Click on the Get started button. Leave this tab open while you move to the next step.
4. Create your webhook, either through the UI or the API. Be sure to use your Request Catcher URL as the Webhook URL.
5. Perform the function of your chosen webhook. For example, if you're testing the member_status_update webhook, then move a test contact to the Error status.

6. Return to your Request Catcher tab. You should now see the information that the webhook sent as a result of your action.

   

Additional resources

• Webhook list
• API calls for managing webhooks
• Request Catcher