# Manage notifications

> Stay informed with automated notifications and reports delivered via email, SMS, or webhooks. Create, update, and manage alerts for transactions, disputes, settlements, and critical business events

<AudienceInfo audiences={['developers', 'partners']} />

Use Payabli's notification functions to create and manage automated notifications and reports for important events. This guide covers the key operations for managing notifications through the API.

## Considerations

Keep these considerations in mind when working with notifications:

* Notifications can be configured at both organization and paypoint levels independently. Setting up the same notification at both levels results in duplicate notifications, as neither configuration overrides the other.
* Multiple notification methods are supported including email, SMS, webhooks, and automated reports.
* Each notification requires a specific event type to trigger it. Learn more about the events [here](/guides/pay-ops-notifications-webhooks-overview#notifications).
* Notifications can be set to run until cancelled or for a specific duration.
* For webhook notifications, you can include custom header parameters.

## Create a notification

Send a POST request to `/api/Notification` to create a notification. The notification can be configured to trigger on specific events and deliver updates via email, SMS, or webhooks. See the [API reference](/developers/api-reference/notification/add-notification) for full documentation.

This example creates a webhook notification that triggers when an application is created:

<EndpointRequestSnippet endpoint="POST /Notification" example="Webhook" />

A successful response will return the ID of the created notification:

<EndpointResponseSnippet endpoint="POST /Notification" example="Webhook" />

## Get notification details

Send a GET request to `/api/Notification/{notificationId}` to retrieve information about a specific notification. See the [API reference](/developers/api-reference/notification/get-notification) for full documentation.

This example retrieves details for notification ID `1717`:

<EndpointRequestSnippet endpoint="GET /Notification/{nId}" example="Get" />

A successful response returns the details of the notification:

<EndpointResponseSnippet endpoint="GET /Notification/{nId}" example="Get" />

## Update a notification

Send a PUT request to `/api/Notification/{notificationId}` to modify an existing notification's configuration. See the [API reference](/developers/api-reference/notification/update-notification) for full documentation.

This example updates a notification to use a different webhook URL and adds a new header parameter:

<EndpointRequestSnippet endpoint="PUT /Notification/{nId}" example="Update" />

A successful response returns the ID of the updated notification as `responseData`:

<EndpointResponseSnippet endpoint="PUT /Notification/{nId}" example="Update" />

## Delete a notification

Send a DELETE request to `/api/Notification/{notificationId}` to remove an existing notification. See the [API reference](/developers/api-reference/notification/delete-notification) for full documentation.

This example deletes notification ID `1717`:

<EndpointRequestSnippet endpoint="PUT /Notification/{nId}" example="Delete" />

A successful response returns the ID of the deleted notification as `responseData`:

<EndpointResponseSnippet endpoint="PUT /Notification/{nId}" example="Delete" />

## Related resources

See these related resources to help you get the most out of Payabli.

<AccordionGroup>
  <Accordion title="Prerequisites">
    * **[Notifications and reports overview](/guides/pay-ops-notifications-webhooks-overview)** - Get automated reports and notifications for key events
  </Accordion>

  <Accordion title="References">
    * **[Webhook notification response reference](/guides/pay-ops-webhooks-payloads)** - Learn more about the payload for each webhook notification response body
  </Accordion>

  <Accordion title="Related topics">
    * **[Webhook quickstart](/guides/pay-ops-developer-webhooks-quickstart)** - Learn to use example code to set up webhooks for payment notifications
  </Accordion>
</AccordionGroup>