Set up webhooks for chat integrations

Webhooks let you post messages to your Cosmos chat channels via HTTP. Connect external services, automation tools, or custom applications to send notifications directly to your team.

How to create a webhook

1. Enter your Cosmos space and click on the Space Dropdown  at the top left
2. Select Space Settings  from the menu
3. In the left sidebar under INTEGRATIONS , click on Webhooks
4. Click the Create a new webhook integration  button
5. Enter a name  for your integration (e.g., "n8n automation" or "GitHub notifications")
6. Select the channel where messages should be posted from the dropdown
7. Click Create integration

Using your webhook

Once created, you'll see:

• Webhook URL: Your unique endpoint (e.g., https://cosmos.video/api/v2/chat/integrations/e875a89c-f001-4530-a7cd-17868dae5279  )

• JSON payload example: Send HTTP POST requests with this structure:

  {"message": "Your message text here"}

• Example request

  curl -H "Content-Type: application/json" \

  -X POST -d '{"message":"Hello world"}' \

  https://cosmos.video/api/v2/chat/integrations/e875a89c-f001-4530-a7cd-17868dae5279

Copy the webhook URL to use in your automation tool or application. Send a POST request with the JSON payload to post messages to the selected channel.

Managing webhooks

To delete a webhook, open the webhook details and click Delete this webhook  at the bottom.