HookTap is now on the GitHub Marketplace

You already know HookTap as the fastest way to receive webhook events on your iPhone. Today we're making it even easier for developers: the HookTap Notify Action is now live on the GitHub Marketplace.

Three lines of YAML are all it takes to get instant push notifications from any GitHub workflow.

What it does

The HookTap/notify-action step sends an HTTP POST to your personal HookTap webhook URL — the same URL you already use from curl, Python, or any other integration. The result lands on your iPhone lock screen within seconds.

Setup in 3 steps

1. Install HookTap on your iPhone and copy your webhook URL from the app.
2. Add a secret to your GitHub repo: Settings → Secrets and variables → Actions → New repository secret
   • Name: HOOKTAP_WEBHOOK_URL
   • Value: your webhook URL
3. Add the action to any workflow:

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

Done. No server. No account signup. Just a URL.

Inputs

The type field controls what happens on your iPhone: push sends an instant notification, feed updates your HookTap feed in real time, widget updates your home screen widget.

Real-world examples

CI pass/fail

Know immediately whether your tests passed or failed — even when you're away from your desk.

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 notifications

- 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 published

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 }}"

HookTap Integrations repo

The GitHub Action is one piece of a larger picture. The hooktap-integrations repository collects ready-to-use examples and recipes for every major platform:

Every integration follows the same simple payload:

{
  "type": "push",
  "title": "Your notification title",
  "body": "Your notification body"
}

If you have a useful integration that's not listed — pull requests are welcome.

Get HookTap

Download on the App Store · hooktap.me