Create a channel

POST

/channels

Creates an email, webhook, or file_drop channel. A webhook channel requires secret — its Standard Webhooks signing secret, stored securely and never returned again. Authorization: organization administrators only. Returns 400 on an invalid body, 404 if a referenced folder is missing, 409 if the slug is taken.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

slugstringRequired1-64 characters

namestringRequired1-120 characters

typeenumRequired

Allowed values:

secretstringRequired

Standard Webhooks signing secret (whsec_-prefixed base64). Required for type ‘webhook’.

folderIdstringOptional>=1 character

Response

The created channel.

channelobject

$	curl -X POST https://api.cloudraker.com/channels \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"slug": "intake",
>	"name": "Intake",
>	"type": "webhook",
>	"secret": "whsec_4f3b2a1c9d8e7f6a5b4c3d2e1f0a9b8c"
>	}'

1	{
2	"channel": {
3	"_id": "63f1a2b4-9c3d-4e5f-8a7b-123456789abc",
4	"slug": "intake",
5	"name": "Intake",
6	"type": "webhook",
7	"address": "https://hooks.cloudraker.com/intake",
8	"webhookSecretVaultId": "vault_9876543210abcdef",
9	"status": "active",
10	"createdAt": "2024-06-01T12:00:00Z",
11	"archivedAt": "",
12	"createdBy": "admin_user_01",
13	"folderId": "folder_1234567890abcdef"
14	}
15	}