Notification Overview#
Apidog enables you to integrate with third-party applications to send notifications to designated recipients when certain events occur. When a specific event is triggered, notifications are sent in real-time to platforms like Slack. Supported notification channels currently include:Only project admins can configure the notification settings. Currently, email notifications are only available for the following events:Automated test completed/failed
Continuous integration completed/failed
Scheduled tasks completed/failed
Notification Targets#
Notification targets are recipients who receive messages through a specific channel when certain events happen.To set up notifications, firstly you need to create a notification target by specifying a name, selecting a channel, and configuring its settings. Each channel has a unique setup process. The sections below will walk you through configuring them step by step.📷 Visual Reference
Slack#
Apidog supports sending notification events to a specific Channel in Slack by integrating Slack apps - Incoming WebHooks in the specified Channel and configuring the Webhook URL of Incoming WebHooks, which can send event messages to the Slack Channel.Configuration field description:| Configuration Field | Required | Description |
|---|
| Notification Name | No | Give a name to the third-party integrated notification to record its purpose. |
| Trigger Events | Yes | Supported events: API changes, schema changes, Document changes, Import data, Automation testing |
| Service URL | Yes | Webhook URL in "Incoming WebHooks - Integration Settings" |
Integrating Apidog Notification with Slack#
Project admins can use third-party integration functions to associate Slack apps - Incoming WebHooks added in Slack - Channels with project notification events in Apidog to push related API changes, documentation changes, testing completions, etc. to the specified Channel in Slack.📷 Step 1: Open channel details
In the Slack channel, click the "Open channel details" option in the top right corner.📷 Step 2: Install Incoming WebHook
In the Integrations - Apps of the specific Channel, install and add Incoming WebHook.📷 Step 3: View Incoming WebHooks
After installation is complete, click the button to the right of Incoming WebHooks - View.📷 Step 4: Configure Incoming WebHooks
This will open the description page of Incoming WebHooks, click Configuration to set up.📷 Step 5: Add to Slack
📷 Step 6: Select Channel and Add Integration
Select the Channel to push Apidog notification event messages to, and click Add Incoming WebHooks integration.📷 Step 7: Get Webhook URL
Get and copy the Webhook URL.📷 Step 8: Create notification target in Apidog
Click "Settings" > "Notifications" > "Notification Targets" > and create a new notification Target.Fill in the notification target name.
Choose Slack as the notification channel.
Paste the Webhook URL obtained from the Incoming WebHooks settings in the Service URL.
📷 Visual Reference: Slack notification message
Teams#
Support for sending notifications to Microsoft Teams allows Workflows in Teams to use these messages as triggers for further actions—such as automatically posting messages in a group or channel—helping teams stay informed about important events from Apidog.Specifically, you can configure a Webhook Trigger within a Workflow. When certain notification events in Apidog are triggered (e.g., API changes, documentation updates, or automated test completions), Apidog will send a POST request to the specified HTTP POST URL of the trigger, carrying the event payload.| Field | Required | Description |
|---|
| Name | Yes | A name that describes the purpose of this notification target |
| HTTP POST URL | Yes | The URL where the Webhook Trigger in the Workflow receives POST requests |
Integrating Apidog Notification with Teams Channels#
📷 Step 1: Create a workflow in Teams
In Microsoft Teams → Workflow, click Create, and you can quickly get started by selecting the template Post to a channel when a webhook request is received.📷 Step 2: Set flow name and account
Set a name for the flow, select the appropriate account, and click Next.📷 Step 3: Choose group and channel
Choose the group and channel where you want to receive the notification, then click Create flow.📷 Step 4: Get HTTP POST URL
Once the flow is created, the HTTP POST URL under the trigger step will be displayed. You can copy it directly or find it later within the trigger step of the flow.📷 Step 5: Configure notification target in Apidog
Paste this HTTP POST URL into the notification target configuration in Apidog.📷 Step 6: Create notification event
Create a notification event in Apidog and associate it with the configured Teams notification target.📷 Step 7: Verify Teams notification
When this notification event is triggered, the previously created workflow will automatically post a message to the selected Teams channel.Webhook#
Supports sending notification events to the HTTP Server. You can send event messages to the HTTP Server by specifying a URL address to receive POST requests.Configuration field description:| Configuration Field | Required | Description |
|---|
| Notification Name | No | Give a name to the third-party integrated notification to record the purpose of the notification. |
| Trigger Event | Yes | Supported events: API changes, Data model changes, Document changes, Import data, Automation testing |
| Server URL | Yes | URL address of the HTTP Server for receiving requests |
| Signature Auth | No | The sent content is encrypted by the HMAC SHA1 encryption algorithm, using a token as the KEY to display the value in hexadecimal (requires a configured token), and contains the prefix sha1= |
Integrating Apidog Notification with Self-hosted HTTP Server#
Project admins can use third-party integration to associate their self-hosted HTTP Server with project notification events in Apidog, to receive notifications for relevant API changes, document changes, and automation test completions in their HTTP Server.To integrate Apidog notification with self-hosted HTTP server, click "Settings" > "Notifications" > "Notification Targets" > and create a new notification Target.📷 Visual Reference
1.
Fill in the notification target name.
2.
Choose Webhook as the channel.
3.
Paste the URL of the self-hosted HTTP Server in the Service URL field.
4.
If the signature verification is enabled, copy and paste the key in the Signature Key field.
Jenkins#
It supports sending notification events to Jenkins service. By configuring Jenkins Webhook URL, event messages can be sent to Jenkins.Configuration field descriptions:| Configuration Field | Required | Description |
|---|
| Notification Name | No | Give a name to the third-party integration notification to record its purpose. |
| Trigger Events | Yes | API changes, Data model changes, Import data, Automation testing. Real-time notifications will be triggered when any of the above events occur. |
| Service URL | Yes | The URL is configured in the Generic Webhook Trigger plugin. |
| Signature Auth | No | Sent to the Generic Webhook Trigger plugin via the Authorization Bearer header. |
Integrating Apidog Notification with Jenkins Service#
Project admins can use third-party integration functionality to associate the Webhook URL configured in the Jenkins Generic Webhook Trigger plugin with project notification events in Apidog, to trigger a build action in Jenkins automatically when events such as API changes, document changes, and automation test completions are triggered, and view messages in the build history.📷 Step 1: Webhook URL configured in Jenkins Generic Webhook Trigger plugin
Create a new view on the Jenkins Dashboard:Click on the view in the previous step to enter Configure>Build Triggers, and select Generic Webhook Trigger. Webhook URL is "http://"+"your service address"+"/generic-webhook-trigger/invoke"The custom token is supported:📷 Step 2: Create a new notification target
Click "Settings" > "Notifications" > "Notification Targets" > and create a new notification Target.Fill in the notification target name.
Choose Jenkins as the channel
If a custom token is used, copy and paste the Token into the Signature Token field.
📷 Visual Reference: Jenkins Build History
Email#
Notifications can be sent via email to specified email addresses. Currently, email notifications are only available for the following events:Automated test completed/failed
Continuous integration completed/failed
Scheduled tasks completed/failed
| Field | Required | Details |
|---|
| Name | Yes | A descriptive name that highlights the purpose or characteristics of the notification target. |
| Notification Email Address | Yes | Enter the email address(es) to receive notifications. You can either select email addresses of project members or manually type in an address. Multiple email addresses are supported. |
Integrating Apidog Notification with Email#
📷 Visual Reference
1.
Fill in the notification target name.
2.
Choose Email as the channel
Notification Events#
You can create notification events to specify which events will trigger notifications to designated recipients (notification targets). To set up a notification event, you need to configure:📷 Visual Reference
Trigger Event#
You can choose from the following notification events to trigger the notification:| Trigger Event | Details |
|---|
| Endpoint Changed | Endpoint Created
Endpoint Updated
Endpoint Deleted |
| Schema Changed | Schema Created
Schema Updated
Schema Deleted |
| Document Changed | Document Created
Document Updated
Document Deleted |
| Data Import | Import (Manual Import)
Import (Auto Sync) |
| Response Component Changed | Response Component Created
Response Component Updated
Response Component Deleted |
| Sprint Branch Changed | Sprint Branch Merged
Sprint Branch Created
Sprint Branch Archived
Sprint Branch Deleted
Sprint Branch Retrieved |
| API Version Changed | API Version Created
API Version Deleted |
| Security Scheme Changed | Security Scheme Created
Security Scheme Updated
Security Scheme Deleted |
For notifications related to automated tests (e.g., automated test completed, continuous integration completed, scheduled task completed), you need to configure the settings individually for each test scenario. This approach is more flexible and better suits real-world use cases.
Notification Targets#
Choose which notification targets will receive the notification when a trigger event happens. You can choose from the notification targets that have already been set up in the project and select multiple targets if needed.However, email notifications are only supported for three specific events:Automated test completed/failed
Continuous integration completed/failed
Scheduled tasks completed/failed
📷 Visual Reference
