CertWatch is currently in Beta. We'd love your feedback!
cURL
curl --request POST \ --url https://api.example.com/channels
Add a new notification channel
curl -X POST https://api.certwatch.app/v1/channels \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "type": "email", "name": "Ops Team", "config": { "email": "[email protected]" } }'
type
email
discord
webhook
name
config
{ "type": "email", "name": "Team Alerts", "config": { "email": "[email protected]" } }
{ "type": "discord", "name": "Discord Alerts", "config": { "webhookUrl": "https://discord.com/api/webhooks/..." } }
{ "type": "webhook", "name": "Custom Integration", "config": { "url": "https://your-endpoint.com/webhook", "headers": { "Authorization": "Bearer secret" } } }
{ "data": { "id": "ch_abc123", "type": "email", "name": "Ops Team", "enabled": true, "config": { "email": "[email protected]" }, "createdAt": "2025-01-08T12:00:00Z", "updatedAt": "2025-01-08T12:00:00Z" }, "meta": { "requestId": "req_xyz789" } }
{ "error": { "code": "invalid_channel_type", "message": "Invalid channel type. Must be one of: email, discord, webhook" } }
{ "error": { "code": "invalid_config", "message": "Email address is required for email channels" } }
{ "error": { "code": "invalid_webhook_url", "message": "The webhook URL is not valid" } }
{ "error": { "code": "channel_limit_reached", "message": "You have reached your channel limit. Upgrade your plan to add more." } }
{ "error": { "code": "invalid_api_key", "message": "The provided API key is invalid" } }