HookTap Notify Action

Send instant iPhone push notifications from your GitHub Actions workflows.

---

Usage

- uses: HookTap/notify-action@v1
  with:
    webhook-url: ${{ secrets.HOOKTAP_WEBHOOK_URL }}
    title: "✅ Build passed"
    body: "main · ${{ github.sha }}"

Inputs

Input	Required	Default	Description
webhook-url	Yes	—	Your HookTap webhook URL
title	Yes	—	Notification title
body	No	""	Notification body text
type	No	push	push · feed · widget

Setup

1. Install HookTap on your iPhone and copy your webhook URL
2. In your GitHub repo go to Settings → Secrets and variables → Actions
3. Add a secret: HOOKTAP_WEBHOOK_URL = your webhook URL
4. Add the action to your workflow

Examples

Notify on every push to main

on:
  push:
    branches: [main]

jobs:
  notify:
    runs-on: ubuntu-latest
    steps:
      - uses: HookTap/notify-action@v1
        with:
          webhook-url: ${{ secrets.HOOKTAP_WEBHOOK_URL }}
          title: "📦 Push to main"
          body: "${{ github.event.head_commit.message }}"

CI – notify on pass or fail

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm ci && npm test

      - uses: HookTap/notify-action@v1
        if: success()
        with:
          webhook-url: ${{ secrets.HOOKTAP_WEBHOOK_URL }}
          title: "✅ Tests passed · ${{ github.ref_name }}"
          body: "${{ github.event.head_commit.message }}"

      - uses: HookTap/notify-action@v1
        if: failure()
        with:
          webhook-url: ${{ secrets.HOOKTAP_WEBHOOK_URL }}
          title: "❌ Tests failed · ${{ github.ref_name }}"
          body: "${{ github.event.head_commit.message }}"

Deploy with status notification

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm run deploy

      - uses: HookTap/notify-action@v1
        if: always()
        with:
          webhook-url: ${{ secrets.HOOKTAP_WEBHOOK_URL }}
          title: "${{ job.status == 'success' && '🚀 Deployed' || '💥 Deploy failed' }} · ${{ github.ref_name }}"
          body: "${{ github.repository }}"

Release notification

on:
  release:
    types: [published]

jobs:
  notify:
    runs-on: ubuntu-latest
    steps:
      - uses: HookTap/notify-action@v1
        with:
          webhook-url: ${{ secrets.HOOKTAP_WEBHOOK_URL }}
          title: "🚀 Released ${{ github.event.release.tag_name }}"
          body: "${{ github.event.release.name }}"

Get HookTap

Download on the App Store · hooktap.me