To set up an outgoing webhook in Act-On, create the webhook & then edit the outgoing endpoint:
Create Your Webhook
- In Act-On, go to Settings > Connectors > Custom Integrations > Outgoing Webhooks.
- In the Endpoints tab, at the top right, click + Add Endpoint:
- Enter the Endpoint URL.
- URL provided by the system receiving the webhook. It acts as a target for the outgoing webhook to deliver data to. If you don’t have a URL yet and want to test the setup, you can click on Svix Play and it will auto-generate a URL.
- Enter a Description.
- In Message Filtering, select the event(s).
- Preconfigured (platform and use case specific) specific events have the name of the event and the platform. Example: automated-program.started.teams
- Preconfigured (platform and use case specific) specific events have the name of the event and the platform. Example: automated-program.started.teams
- Optional: Depending on the receiving end the URL may also include a secure token that is used to ensure the authenticity of the message by adding a custom header in Advanced Configuration > Custom Headers.
Test Your Webhook
Once created, a webhook endpoint can be tested by navigating to the Testing tab. You can choose from the endpoint-specific subscribed and unsubscribed events.
The test message will be displayed in the Attempted Messages section with the status.
Confirmation of successful test (in this case, it was a Slack message that was triggered)
Edit an Outgoing Endpoint
The following fields can be modified once the endpoint is created:
Field | Notes |
Endpoint URL | |
Description | |
Subscribed events |
Can add or remove |
Custom Headers |
Can modify existing, delete one, or add more (no Edit button displays) |
Channels |
Channels are used to connect outgoing Webhooks to certain activities in Act-On. For example, a Form submission-based webhook includes in the 'Channels" field all the form IDs that are set up to use this webhook. Webhooks initiated by an Automated Program show the program ID. Webhooks triggered by a lead score change show the score threshold and score sheet. Generally, these channels are managed in the Form, Program, or score sheet area of Act-On, but you can also edit them directly in the Webhook area. Each webhook is limited to 10 individual channels. Once this is exceeded, you may need to create another version of the webhook for additional channels. |
FAQs
Source Validation (IP Allowlisting)
To configure IP allowlisting for webhooks that Act-On may be sending to your system, please use 54.200.92.142
HMAC Signature Verification
For extra security, you can use HMAC signature verification.For details, please see documentation from our webhook service provider here.
The Signing Secret is generated when you configure your endpoint, for example:
Rate Limiting & Throttling
In the advanced tab of the webhook setup, you can set a rate limit to throttle the requests that will come into your endpoint.