Skip to main content

Update An Sms Notifier

Update an sms notifier

HTTP Request

PATCH/api/notifications/notifiers/sms/:id

Authorization

Authorization

  • Required: Yes
  • Permission: Staff with SMSNotifierPermission or Admin
  • Permission Code: 2813
  • Authentication: Token-based (Authorization: Token <your_api_key>)

Path Parameters

ParameterTypeRequiredDescription
idIntegerYesUnique ID of the sms notifier to update

Request Body

FieldTypeRequiredDescription
nameStringYesName of the sms notifier
backendStringYesBackend name of the sms notifier (choices: `ippanel`, `melipayamak`)
settingsJsonFieldNoExtra settings required for the sms notifier (default: empty dict)

Setting Validation

The settings field if provided should match the following rules:

MeliPayamak

  • It should contain a key named token with a string value
  • It may contain a key named number with a string value of more than 4 digits

Ippanel

  • It should contain a key named token with a string value
  • It should contain a key named from_number with a string value of an iraninan mobile number starting with +98

Example Requests

1import requests
2response = requests.post('http://www.example.com/api/notifications/notifiers/sms/49', json={
3  "name": "some edited name"
4})
5print(response.json())

Response Fields

FieldTypeDescription
idIntegerUnique ID of the sms notifier.
nameStringName of the sms notifier
backendStringName of the sms notifier backend
settingsJsonFieldJson key-value settings required for each notifier
created_atString (ISO 8601)Timestamp when the sms notifier was created.
updated_atString (ISO 8601)Timestamp when the sms notifier was last updated.

Response Example

{
"id": 6,
"name": "edited_melipayamak",
"backend": "melipayamak",
"settings": {
"token": "another_token",
"number": "091502306589"
},
"created_at": "2025-12-28T15:56:29.610626Z",
"updated_at": "2025-12-28T16:06:49.107530Z"
}