GitHub Actions

Announce every release on social media, from your workflow

One step in a GitHub Actions workflow posts your release, blog post or changelog to LinkedIn, Bluesky, Mastodon, Threads, Telegram, Discord and the rest of your accounts. One secret, no app registration per network.

The action is free and open source (MIT), with no dependencies.

The whole workflow

name: Announce release
on:
  release:
    types: [published]

jobs:
  announce:
    runs-on: ubuntu-latest
    steps:
      - uses: Perufitlife/postwire-action@v1
        with:
          api_key: ${{ secrets.POSTWIRE_API_KEY }}
          text: |
            ${{ github.event.repository.name }} ${{ github.event.release.tag_name }} is out.

            ${{ github.event.release.html_url }}

Set it up in three steps

  1. Connect your accounts in PostWireCreate a free account and sign in to each network from your dashboard. GitHub never sees those logins.
  2. Save the API key as a secretCopy the key from the dashboard and add it to the repository as POSTWIRE_API_KEY (Settings, Secrets and variables, Actions).
  3. Add the stepPaste the workflow above. With no platforms input it posts to every connected account that can take the post; name them to choose, for example bluesky, linkedin.

What to automate with it

When this happensThe step posts
A release is publishedThe version and the link to the release notes
A blog post is merged into mainThe title, the link and the cover picture (photo_url)
A weekly schedule runsThe changelog of the week
A demo video is built by the pipelineThe video (video_url) to TikTok, YouTube and Instagram

Before you build

  • Pictures and videos are public links. The step takes a link to the file, not a path in the runner.
  • Some networks need media. TikTok and YouTube take only video and Instagram needs a picture or video; they are skipped for a text-only post unless you name them.
  • The free plan sends one post to two networks. The step says so in a notice and does not fail.
  • The links come back. The outputs url and urls hold the published posts, and the job summary lists them.

Questions

How do I post to social media from GitHub Actions?
Add the PostWire action to a workflow with your API key and the text of the post. One step publishes it to every social account you connected in PostWire.
Do I need a developer app or token for each network?
No. You sign in to each network once in PostWire. The workflow only holds one secret, the PostWire API key.
Is it free?
The action is free and open source. PostWire has a free plan; paid plans lift its limits.
Will a failed post break my release?
Only if you want it to. Set fail_on_error to false and the step warns instead of failing.
I use another CI.
The action is a thin layer over one HTTP call; the same request works from any pipeline. See the API docs.

Source code: github.com/Perufitlife/postwire-action.

Your next release can announce itself

Free PostWire account, one secret, one step.