Update An email Notifier

Update an email notifier

HTTP Request

PATCH/api/notifications/notifiers/email/:id

Authorization

Authorization

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

Path Parameters

Parameter	Type	Required	Description
id	Integer	Yes	Unique ID of the email notifier to update

Request Body

Field	Type	Required	Description
name	String	Yes	Name of the email notifier
host	String	Yes	Host name of the email notifier
port	Integer	No	Port number of the email notifier
username	String	Yes	Username of the email notifier
password	String	Yes	Password of the email notifier
from_email	String	Yes	Sending email address of the notifier
use_tls	Boolean	No	Whether using tls or not (default=true)
use_ssl	Boolean	No	Whether using ssl or not (default=false)
fail_siently	Boolean	No	Whether failing silently or not (default=false

Example Requests

🐍 Python

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

🌐 Curl

1curl -X POST "http://www.example.com/api/notifications/notifiers/email/49" -H "Content-Type: application/json" -d '{
2  "name": "some edited name"
3}

Response Fields

Field	Type	Description
id	Integer	Unique ID of the email notifier.
name	String	Name of the email notifier
host	String	Host name of the email notifier
port	Integer	Port number of the email notifier
username	String	Username of the email notifier
password	String	Password of the email notifier
from_email	String	Sender email address of the email notifier
use_tls	Boolean	Whether the email notifier use tls or not
use_ssl	Boolean	Whether the email notifier use ssl or not
fail_silently	Boolean	Whether the email notifier will fail silently in case of error
created_at	String (ISO 8601)	Timestamp when the email notifier was created.
updated_at	String (ISO 8601)	Timestamp when the email notifier was last updated.

Response Example

{
    "id": 8,
    "name": "hamgam_mail_edited",
    "host": "mail.hamgam.online",
    "port": 887,
    "username": "info",
    "password": "somepassword",
    "from_email": "info@hamgam.online",
    "use_tls": true,
    "use_ssl": true,
    "fail_silently": false,
    "created_at": "2025-12-28T17:43:38.130046Z",
    "updated_at": "2025-12-28T17:52:56.081474Z"
}