Webhooks allow you to receive real-time notifications about specific events in your Voicenotes account. This guide will walk you through setting up and managing webhooks to integrate Voicenotes with your own applications or services.
Accessing the Webhooks Integration
Log in to your Voicenotes account.
Click on your profile icon in the top-right corner.
Navigate to "Integrations" in the sidebar.
Click on "Webhooks" to access the webhook management page.
Creating a Webhook
Follow these steps to create a new webhook:
1. Navigate to Webhooks
From the Webhooks page, you will see a list of your existing webhooks (if any).
2. Add Your Webhook URL
Click on the "Add Webhook" button.
In the "Webhook URL" field, enter the URL where you want to receive POST requests.
Note: Ensure that your URL is accessible and can accept POST requests from Voicenotes.
3. Select Events
Choose the events that will trigger the webhook:
Creating Notes: Triggers when a new note is created.
Updating Notes: Triggers when an existing note is updated.
Deleting Notes: Triggers when a note is deleted.
Tip: You can select one or multiple events based on your integration needs.
4. Create the Webhook
Review your settings.
Click on the "Create" button to finalize the webhook setup.
You will be redirected back to the Webhooks list, where your new webhook will appear.
Managing Your Webhooks
Enabling or Disabling a Webhook
In the Webhooks list, you'll see a toggle switch next to each webhook.
To Disable: Toggle the switch off. The webhook will no longer send notifications.
To Enable: Toggle the switch on. The webhook will resume sending notifications.
Note: Disabling a webhook does not delete it; you can re-enable it at any time.
Deleting a Webhook
In the Webhooks list, locate the webhook you want to delete.
Click on the three dots menu (⋮) next to the webhook.
Select "Delete" from the dropdown options.
Warning: Deleting a webhook is irreversible. You will need to create a new webhook if you want to restore it.
Available Events
Creating Notes: Triggered when a new note is added to your Voicenotes account.
Updating Notes: Triggered when an existing note is modified.
Deleting Notes: Triggered when a note is removed from your account.
Each event will send a payload to your specified webhook URL containing relevant data about the note and the event type.
Need More Help?
If you have any questions or encounter any issues, please reach out to us at [email protected]