01
Before you start
- A Reelspan account with your networks connected to a profile. The free plan includes every network: start free.
- An API key from the dashboard (Developers → API keys). Keys can be limited to the scopes a tool needs.
02
Add your key as a secret
Create an API key in the dashboard, then in the repository open Settings → Secrets and variables → Actions and add it as REELSPAN_API_KEY.
03
Add the step
This workflow posts every published release to five networks. external-id makes a re-run post nothing twice.
on:
release:
types: [published]
jobs:
announce:
runs-on: ubuntu-latest
steps:
- uses: Reelspan/reelspan-action@main
with:
api-key: ${{ secrets.REELSPAN_API_KEY }}
profile: my-brand
platforms: x, linkedin, bluesky, mastodon, discord
text: |
${{ github.event.release.name }} is out
${{ github.event.release.html_url }}
external-id: ${{ github.event.release.tag_name }}04
Going further
- github.com/Reelspan/reelspan-action: The action is open source; it also takes video, photos and PDFs from the workspace or a URL.
- Every field each network takes, scheduling, webhooks and errors: the docs.
- Per-network walkthroughs: upload guides. Is everything publishing right now? Status.
- Other ways in: all integrations.