Manage notification profiles

View as Markdown

A notification profile defines where event notifications are sent and how they are delivered. Every webhook subscription must include a valid notification profile to function correctly. You can create, update, and delete notification profiles through the Infobip web interface or the Subscriptions API.

Prerequisites [#prerequisites]

To manage notification profiles, you need:

Infobip account: An active account.
Webhook endpoint: A publicly accessible URL ready to receive event notifications.
Authentication settings (optional): If you want to secure delivery. See Manage authentication settings.
Certificate (optional): If you want mutual TLS. See Manage certificates.

For details on how profiles relate to subscriptions, see Understanding webhook subscriptions.

Create a notification profile [#create]

Create a notification profile when setting up a new subscription, or create a standalone profile for reuse across multiple subscriptions.

Log in to the Infobip web interface and go to Developer Tools > Subscriptions Management.
Open the Notification profiles tab.
Select Create notification profile.
Enter the profile information:
- Notification profile name: Use only letters, numbers, dashes, or underscores.
- Webhook URL: The destination URL that receives event notifications.
(Optional) Add response validation:
- Response body regex: A text pattern that must appear in the response body for the delivery to be considered successful.
- Response regex: A pattern matching the expected HTTP status codes (for example, 2[0-9]{2} to accept any 2xx response).
(Optional) Under Security settings, select an authentication setting or create a new one. See Manage authentication settings for details on each method.

NOTE
Use at least basic authentication to protect your webhook endpoint. For stronger security, combine authentication with mutual TLS certificates.
(Optional) Apply a certificate for mutual TLS (mTLS) security. See Manage certificates for setup instructions.

(Optional) Configure advanced settings:

Setting	Range	Description
Max bucket size	1 to 2000	Maximum messages per request
Window size	20 to 10000	Concurrent connections
Connect timeout	300 to 30000 ms	Connection timeout
Read timeout	1000 to 90000 ms	Read timeout
SSL protocols	TLS v1.2, v1.3	Enabled SSL protocols
Headers	Key-value pairs	Custom headers sent with requests
Rate limit	1 to 5000	Requests per second

Select Save to create your notification profile.

Use the Create notification profile API endpoint.

You can create new security settings inline or reference existing ones by authId.

The profileId cannot be changed after creation.

View or edit a notification profile [#view-edit]

Log in to the Infobip web interface and go to Developer Tools > Subscriptions Management.
Open the Notification profiles tab and search for your profile using the search bar.
Select the three-dot menu next to the profile and choose:
- View: See a summary of your profile configuration
- Edit: Make changes to webhook URL, response validation, security, certificate, or advanced settings
Make your changes and select Update.

Delete a notification profile [#delete]

Log in to the Infobip web interface and go to Developer Tools > Subscriptions Management.
Open the Notification profiles tab and search for your profile using the search bar.
Select the three-dot menu next to the profile and select Delete.

IMPORTANT

Before deleting a profile, verify that no active subscriptions use it. Review Subscription hierarchy and deletion rules to understand deletion dependencies.

For details on what notification profiles include, standalone profiles, and how to choose between shared and independent setups, see Subscription components.

Related pages

Manage webhook subscriptions
Create and manage subscriptions.

Manage authentication settings
Secure your webhook endpoints with Basic, HMAC, or OAuth.

Manage certificates
Enable mutual TLS for endpoint authentication.

Subscription hierarchy and deletion rules
Component relationships and deletion dependencies.