---
title: "Update notification setting"
method: PATCH
path: "/orgunit/{orgunitId}/groups/{groupId}/notification-url"
tags: ["Webhooks"]
---

# Update notification setting

`PATCH /orgunit/{orgunitId}/groups/{groupId}/notification-url`

Authentication methods provided for secure communication of webhooks are given below. For each URL, value of authentication type must be passed.

| Authentication Type | Value | Description |
| ------------ | --- | --------------------------------------------------------------------------------------------------------- | 
| No Authentication | none | Webhooks are accessible without any authentication requirements. RequiredParameters: `authenticationType`|
 | Basic Authentication | basic | Users must include a username and password with each webhook which is encoded and sent with request. RequiredParameters: `authenticationType`, `userName`, `password`|
| Bearer Token Authentication | oauth | In this method, token generated by the server are included in request headers. RequiredParameters: `authenticationType`, `clientId`, `clientSecret`|

## Path parameters

- `orgunitId` string, required
- `groupId` string, required

## Request body

- WebHook
  - `callbackUrlEnabled` boolean
  - `statusUrlEnabled` boolean
  - `personalUrlEnabled` boolean
  - `callbackUrlSettings` CallbackUrlSettings[], nullable
    - `callBackUrl` string, nullable
    - `authenticationType` string, nullable
    - `userName` string, nullable
    - `password` string, nullable
    - `tokenAuthority` string, nullable
    - `clientId` string, nullable
    - `clientSecret` string, nullable
    - `clientScope` string, nullable
  - `statusUrlSettings` StatusUrlSettings[], nullable
    - `statusUrl` string, nullable
    - `authenticationType` string, nullable
    - `userName` string, nullable
    - `password` string, nullable
    - `tokenAuthority` string, nullable
    - `clientId` string, nullable
    - `clientSecret` string, nullable
    - `clientScope` string, nullable
  - `personalUrlSettings` PersonalLinkSettings[], nullable
    - `personallinkurl` string, nullable
    - `authenticationType` string, nullable
    - `userName` string, nullable
    - `password` string, nullable
    - `tokenAuthority` string, nullable
    - `clientId` string, nullable
    - `clientSecret` string, nullable
    - `clientScope` string, nullable

## Response `200`

Success

- ExternalApiResponseNew
  - `appCode` string
  - `message` string
  - `isError` boolean

## Other responses

- `500` — Server Error

---

[API](https://skmtc.net/ministrybytext/apis/pbt-api-documentation.md) · [All operations](https://skmtc.net/ministrybytext/apis/pbt-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ministrybytext/pbt-api-documentation/versions/ca6e9c8f430d/schema)
