pve_notification_endpoint_create
Create a notification endpoint for Proxmox VE (e.g., gotify, SMTP, sendmail, or webhook). Dry-run by default; set confirm=true to execute.
Instructions
MUTATION: create a PVE notification endpoint. ep_type = gotify|smtp|sendmail|webhook.
options carries the endpoint-specific config (sendmail: {"mailto-user":"root@pam"};
gotify: {"server":..,"token":..}; webhook: {"url":..}). Additive, low risk. Dry-run by
default (returns a PLAN); confirm=True executes and returns {"status": "ok", "result": null} (no further
payload). To modify an existing endpoint instead use pve_notification_endpoint_update.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Unique name for the new notification endpoint | |
| comment | No | Optional free-text comment stored with the endpoint | |
| confirm | No | False (default) returns a dry-run PLAN only; True executes the creation | |
| ep_type | Yes | Notification endpoint type: 'gotify', 'smtp', 'sendmail', or 'webhook' | |
| options | No | Endpoint-specific config fields, e.g. sendmail: {'mailto-user':'root@pam'}; gotify: {'server':.., 'token':..}; webhook: {'url':..} | |
| proximo_target | No | Which configured Proxmox target to run this call against — a target name from your multi-target config (a specific PVE/PBS/PMG/PDM box). Omit to use the single/default target from the environment; the selection applies only to this call. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |