API referenceNotification channels
Create a notification channel
POST
An email channel is sent a confirmation link and receives nothing until it is followed. A webhook channel is usable at once; its signing secret is in this response only.
keystoneheader
X-Auth-Token<token>application/json- body
address?stringFor an email channel: the address. It receives nothing until its owner follows the confirmation link sent to it.
Length
length <= 254name*stringLength
1 <= length <= 64project_id?stringThe owning project. Omitted, it is the caller's own project.
Length
length <= 255type*stringValue in
"email""webhook"url?stringFor a webhook channel: an https URL on a public address. Deliveries are signed; see X-Budget-Signature.
Length
length <= 2048Created
application/json- response
address?stringcreated_at*stringFormat
date-timecreated_by*stringid*stringname*stringproject_id*stringsecret?stringA webhook's signing secret. It is returned only when the channel is created and when the secret is rotated.
status*stringValue in
"pending_confirmation""confirmed"type*stringurl?stringcurl -X POST "https://example.com/v1/notification_channels" \ -H "Content-Type: application/json" \ -d '{ "name": "string", "type": "email" }'{ "address": "string", "created_at": "2019-08-24T14:15:22Z", "created_by": "string", "id": "string", "name": "string", "project_id": "string", "secret": "string", "status": "pending_confirmation", "type": "string", "url": "string"}