Skip to content

A simple and Quick, production ready GitHub Action to send JSON alerts and notifications via POST requests to Slack, email services, logging endpoints, and more.

License

Notifications You must be signed in to change notification settings

Hookflo/notify-action

Use this GitHub action with your project
Add this Action to an existing workflow or create a new one
View on Marketplace

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 

Repository files navigation

📡 HookFlo Notify Action

A lightweight GitHub Action by HookFlo to send JSON notifications to any HTTP endpoint using secure token headers. Ideal for Slack alerts, email notifications, CI/CD event tracking, or internal monitoring.


✨ Why HookFlo?

  • 🔗 Centralized Webhook Management — Create & manage secure webhooks from your HookFlo Dashboard.
  • 🎨 Custom Templates — Design Slack or Email notification templates without code.
  • 📊 Real-Time Logs — Monitor delivery and debug failures from your HookFlo Dashboard.
  • 🛡️ Secure By Default — Token-based authentication for every request.

🚀 Sign up at HookFlo to get your Webhook URL, ID, and Secret.


🚀 Features

  • Minimal Setup — Just URL, token, and payload.
  • Flexible JSON Payloads — Send any event data.
  • Secure Headersx-webhook-token and x-webhook-id included.
  • Zero Dependencies — Fast, Docker-free execution.

📦 Inputs

Input Name Description Required
webhook_url Your Webhook URL from HookFlo. ✅ Yes
webhook_id Webhook ID used in x-webhook-id header. ✅ Yes
webhook_secret Secret token used in x-webhook-token header. ✅ Yes
payload Optional JSON payload to send as request body. ❌ No

🛠️ Setup Instructions

  1. Sign up on HookFlo
  2. Create a Custom Webhook — Copy your Webhook URL, ID, and Secret.
  3. Set Up Templates — Customize Slack or Email notifications in your dashboard.
  4. Monitor Logs — View delivery history and debug from HookFlo's real-time dashboard.

📄 Example Workflow

- name: Send Notification via HookFlo
  uses: hookflo/hookflo-notify-action@v1.5
  with:
    webhook_url: ${{ secrets.HOOKFLO_URL }}
    webhook_id: ${{ secrets.WEBHOOK_ID }}
    webhook_secret: ${{ secrets.WEBHOOK_SECRET }}
    payload: |
      {
        "event": "deployment_failed",
        "repository": "${{ github.repository }}",
        "branch": "${{ github.ref }}",
        "run_id": "${{ github.run_id }}",
        "status": "failed"
      }

About

A simple and Quick, production ready GitHub Action to send JSON alerts and notifications via POST requests to Slack, email services, logging endpoints, and more.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published