signaloid-cli webhooks create

Create a new webhook.

Synopsis

signaloid-cli webhooks create --url <url> [options]

Options

Option	Required	Description
--url <url>	Yes	Target URL for webhook notifications
--events <e1,e2,...>	No	Comma-separated event list
--description <text>	No	Webhook description
--status <active|disabled>	No	Initial status

Description

Creates a new webhook that will receive HTTP POST requests when subscribed events occur in your Signaloid account. The webhook will send event data as JSON payloads to the specified URL.

Examples

signaloid-cli webhooks create \
  --url https://api.example.com/webhooks/signaloid \
  --events build.completed,task.completed \
  --description "Production notifications"

Notes

• The target URL must be publicly accessible and support HTTPS
• If no events are specified, the webhook subscribes to all events
• Webhooks are created in active status by default unless --status disabled is specified
• The webhook URL endpoint should return a 2xx status code to confirm successful delivery

Troubleshooting

Webhook creation fails with "Invalid URL"

• Ensure the URL is properly formatted with the https:// protocol
• Verify that the URL is publicly accessible

Events not being delivered

• Check that the webhook status is active
• Verify the target URL is responding correctly
• Use webhooks stats to check delivery status

See Also

• signaloid-cli webhooks - Webhook command overview
• signaloid-cli webhooks list - List webhooks
• signaloid-cli webhooks update - Update webhook configuration
• signaloid-cli webhooks enable - Enable webhooks