Webhooks

Webhooks let external services post messages into a Fluffwire channel automatically — without needing a bot account or a persistent connection. They are ideal for one-way notifications like CI/CD alerts, monitoring alarms, or form submissions.

Creating a Webhook

Only the server owner can create webhooks.

1. Open Server Settings → Webhooks.
2. Click Create Webhook.
3. Give it a name (shown as the message author) and choose which channel it posts to.
4. Copy the webhook URL — it looks like:

   https://app.fluffwire.com/api/webhooks/{id}/{token}

   Keep the token secret. Anyone with the URL can post messages to that channel.

Posting a Message

Send a POST request to the webhook URL with a JSON body:

POST https://app.fluffwire.com/api/webhooks/{id}/{token}
Content-Type: application/json

{
  "content": "Deploy finished successfully ✅"
}

The message appears in the channel under the webhook's name with a BOT badge. No authentication header is needed — the token in the URL is the credential.

Rate limit: 5 messages per 5 seconds.

Managing Webhooks

From Server Settings → Webhooks (owner only) you can:

• Rename a webhook or point it at a different channel
• Delete a webhook — the URL immediately stops working

Example: GitHub Actions

- name: Notify Fluffwire
  run: |
    curl -X POST "${{ secrets.FLUFFWIRE_WEBHOOK_URL }}" \
      -H "Content-Type: application/json" \
      -d '{"content": "✅ Build passed on `${{ github.ref_name }}`"}'

Store the full webhook URL as a secret in your repository settings.