API and Zapier & Make
StackSignal · not affiliated with Substack, LinkedIn, Instagram, Facebook, X or YouTube
StackSignal connects to Zapier, Make and your own tools through a small web API. Use it to start an automation when something happens in your account (a new post, a new milestone, your weekly stats), or to save a draft, ask to schedule a post or track a rival from another app. It is available on the Pro plan and above.
Get a key
- Sign in to StackSignal and open Settings, Zapier & Make.
- Tick the box, then press Make my key.
- Copy the key. It is shown once, and you can make a new one at any time.
- Paste it into Zapier or Make when it asks. Press Revoke on the same card and it stops working straight away.
Members on the Hobbyist plan see an upgrade line instead of the key.
Sign in
Send your key on every call, as a Bearer token. X-API-Key: <key> works too. Everything is over HTTPS at https://stacksignal.app/api/v1.
curl "https://stacksignal.app/api/v1/me" \
-H "Authorization: Bearer sk_ssauto_YOUR_KEY"A key can read your own numbers, posts and Notes, save drafts, ask to schedule a post and add a rival. It can never send a message, comment or reply, and it can never post straight away: a scheduled post only goes out if you tap Approve in StackSignal.
Triggers
Zapier and Make check these addresses on a timer. Every answer is { "data": [...], "next_cursor": ... }, newest first. Every item has a stable id and a created_at. These options work on all seven: since, platform (substack, linkedin, instagram or youtube), limit (1 to 100) and cursor.
New Post Published (Make: Watch New Posts)
One of your own posts (Substack article or podcast, LinkedIn, Instagram or YouTube) appears in StackSignal. GET /api/v1/triggers/posts
curl "https://stacksignal.app/api/v1/triggers/posts?limit=1" \
-H "Authorization: Bearer sk_ssauto_YOUR_KEY"{
"data": [
{
"id": "8f14e45f-ceea-467f-a0e6-4a9b1d0c2e11",
"created_at": "2026-11-06T07:40:12.000Z",
"platform": "linkedin",
"handle": "yourname",
"kind": "linkedin",
"title": "Three things I stopped doing this year",
"excerpt": "Three things I stopped doing this year, and what happened next.",
"url": "https://www.linkedin.com/feed/update/urn:li:activity:7390000000000000000/",
"posted_at": "2026-11-06T07:30:00.000Z",
"likes": 312,
"comments": 41,
"restacks": 9,
"engagement": 425
}
],
"next_cursor": null
}New Note Posted (Make: Watch New Notes)
One of your own Substack Notes appears in StackSignal. GET /api/v1/triggers/notes
curl "https://stacksignal.app/api/v1/triggers/notes?limit=1" \
-H "Authorization: Bearer sk_ssauto_YOUR_KEY"{
"data": [
{
"id": "c9f0f895-fb98-4b91-9c1d-3f2a7d5e8b10",
"created_at": "2026-11-06T09:02:44.000Z",
"platform": "substack",
"handle": "yourpublication",
"kind": "note",
"title": null,
"text": "Morning! One small thing to try today: reply to the first comment you get within ten minutes.",
"url": "https://substack.com/@yourpublication/note/c-170000000",
"posted_at": "2026-11-06T09:00:00.000Z",
"likes": 48,
"comments": 7,
"restacks": 3,
"engagement": 64
}
],
"next_cursor": null
}New Subscribers Synced (Make: Watch New Subscribers)
Your audience on a connected platform grew. Counts only, never who the people are. GET /api/v1/triggers/subscribers
curl "https://stacksignal.app/api/v1/triggers/subscribers?limit=1" \
-H "Authorization: Bearer sk_ssauto_YOUR_KEY"{
"data": [
{
"id": "3b5d5c3712955042212316ab",
"created_at": "2026-11-05T23:00:00.000Z",
"platform": "substack",
"handle": "yourpublication",
"unit": "subscribers",
"new_count": 14,
"previous_total": 1186,
"total": 1200,
"date": "2026-11-05"
}
],
"next_cursor": null
}Weekly Stats Ready (Make: Watch Weekly Stats)
Your weekly growth summary is ready (once a week). GET /api/v1/triggers/weekly-stats
curl "https://stacksignal.app/api/v1/triggers/weekly-stats?limit=1" \
-H "Authorization: Bearer sk_ssauto_YOUR_KEY"{
"data": [
{
"id": "week_2026-11-02",
"created_at": "2026-11-02T06:00:00.000Z",
"week_start": "2026-11-02",
"headline": {
"value": "+48",
"label": "new subscribers this week"
},
"audience": {
"unit": "subscribers",
"total": 1200,
"change": 48
},
"top_post": {
"title": "The one habit that doubled my open rate",
"url": "https://yourpublication.substack.com/p/the-one-habit"
},
"goal": {
"label": "Publish 3 Notes",
"done": 3,
"target": 3,
"hit": true
},
"next_move": "Post a Note on Tuesday morning that asks your readers one question.",
"app_url": "https://stacksignal.app/app"
}
],
"next_cursor": null
}Rival Breakout (Make: Watch Rival Breakouts)
A rival you track has a post doing at least 3 times their usual. GET /api/v1/triggers/rival-breakouts
curl "https://stacksignal.app/api/v1/triggers/rival-breakouts?limit=1" \
-H "Authorization: Bearer sk_ssauto_YOUR_KEY"{
"data": [
{
"id": "a87ff679a2f3e71d9181a67b",
"created_at": "2026-11-05T18:15:00.000Z",
"platform": "substack",
"rival": {
"handle": "arivalwriter",
"name": "A Rival Writer"
},
"post": {
"title": "Why I post at 6am",
"url": "https://arivalwriter.substack.com/p/why-i-post-at-6am",
"posted_at": "2026-11-05T18:15:00.000Z",
"likes": 640,
"comments": 88,
"restacks": 41
},
"multiple": 4.2,
"your_angle": "Try a short personal story from your own week, and the lesson you took from it."
}
],
"next_cursor": null
}New Message or Comment (Make: Watch New Messages or Comments)
An Instagram message arrives (who and when, never the words), or one of your own posts gets more comments (the count only). GET /api/v1/triggers/messages
curl "https://stacksignal.app/api/v1/triggers/messages?limit=1" \
-H "Authorization: Bearer sk_ssauto_YOUR_KEY"{
"data": [
{
"id": "9f2c41d07a3b5e6c18d2f4a0",
"created_at": "2026-11-07T18:42:00.000Z",
"kind": "dm",
"platform": "instagram",
"from": "@areader",
"post": null,
"comments": null
}
],
"next_cursor": null
}Growth Milestone Reached (Make: Watch Growth Milestones)
Your audience on a connected platform crosses a milestone, such as 1,000 subscribers, for the first time. GET /api/v1/triggers/milestones
curl "https://stacksignal.app/api/v1/triggers/milestones?limit=1" \
-H "Authorization: Bearer sk_ssauto_YOUR_KEY"{
"data": [
{
"id": "4e81c0b2d95a7f3e6b1c2d48",
"created_at": "2026-11-06T23:00:00.000Z",
"platform": "substack",
"handle": "yourpublication",
"unit": "subscribers",
"milestone": 1000,
"count": 1012,
"next_milestone": 2500,
"date": "2026-11-06"
}
],
"next_cursor": null
}Actions
The platform for a draft or a scheduled post is one of substack, linkedin, instagram or facebook. A scheduled post needs a time at least 5 minutes ahead and within 60 days. Instagram needs one public https link to a .jpg or .mp4 in media_url.
Create Draft Note (Make: Create a Draft Note)
Saves a draft (a Substack Note by default). It is only saved: never scheduled or posted. POST /api/v1/drafts
curl -X POST "https://stacksignal.app/api/v1/drafts" \
-H "Authorization: Bearer sk_ssauto_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"platform":"substack","text":"Morning! One small thing to try today."}'{
"data": {
"id": "e4da3b7f-bbce-4345-9d77-7f2f1c3b5a21",
"platform": "substack",
"status": "draft",
"text": "Morning! One small thing to try today.",
"characters": 38,
"scheduled": false,
"posted": false
}
}Schedule Post (Make: Schedule a Post)
Asks to schedule a post. It waits for your Approve in StackSignal, under Posting, and only goes out if you approve it in time. POST /api/v1/schedules
curl -X POST "https://stacksignal.app/api/v1/schedules" \
-H "Authorization: Bearer sk_ssauto_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"platform":"linkedin","text":"Three things I stopped doing this year.","when":"2026-11-10T05:30:00.000Z"}'{
"data": {
"id": "1679091c-5a88-4faf-9fb1-6a1b2c3d4e5f",
"draft_id": "e4da3b7f-bbce-4345-9d77-7f2f1c3b5a21",
"platform": "linkedin",
"scheduled_for": "2026-11-10T05:30:00.000Z",
"status": "awaiting_approval",
"text": "Three things I stopped doing this year.",
"approve_url": "https://stacksignal.app/app/posting",
"note": "Nothing is scheduled yet. It waits for your Approve in StackSignal > Posting, and only goes out if you approve it in time."
}
}Add Rival (Make: Add a Rival)
Starts tracking a public creator account as a rival (at most 5, 15 or 40 per platform, by the member's plan). POST /api/v1/rivals
curl -X POST "https://stacksignal.app/api/v1/rivals" \
-H "Authorization: Bearer sk_ssauto_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"platform":"substack","handle":"arivalwriter"}'{
"data": {
"platform": "substack",
"handle": "arivalwriter",
"already_tracking": false
}
}Limits and errors
- 600 calls an hour for each key, and 1,500 an hour for each member across all keys. A Zap checking once a minute uses 60.
- Drafts: 20 a day. Requests are limited to 16 KB.
- Every error has one shape:
{ "error": { "code": "snake_case_name", "message": "A plain sentence." } }.
| Status | What it means |
|---|---|
401 invalid_token | The key is missing, wrong or revoked. Make a new one in Settings, Zapier & Make. |
| 403 | Your plan does not include this (Hobbyist), or the plan has lapsed. |
429 rate_limited | This hour's allowance is used up. The Retry-After header says how many seconds to wait. |
503 temporarily_unavailable | Try again shortly. Retry-After says when. |
{
"error": {
"code": "invalid_token",
"message": "A valid StackSignal access token or API key is required. Create one in StackSignal under Settings, Zapier & Make."
}
}OpenAPI
The full machine-readable description (OpenAPI 3.1) is at /api/v1/openapi.json. No key is needed to read it.
Help
Questions, or something not working? Email support@stacksignal.app and we reply within one working day. Include the email you sign in with. Never send your key.