| name | sales-shortstack |
| description | ShortStack (shortstack.com) platform help — campaign platform for contests, giveaways, sweepstakes, quizzes, refer-a-friend, instant-win, and hashtag/comment-to-enter promotions, with lead capture, automatic winner selection, and analytics. Developer surface: an Entries API (`entries.shortstack.com`, `Authorization: Token token=`, per_page ≤5000, `{data:[...]}` response) and real-time signed webhooks (`X-Ss-Signature` HMAC of body + secret) on each new entry, plus a Webhooks management API, native Mailchimp/HubSpot/Salesforce, and Zapier. Free-forever plan + paid tiers. Use when reading entries/leads via the API, verifying or wiring the signed webhook, syncing entrants to an ESP/CRM or Zapier, picking a campaign type, handling giveaway fraud, or exporting leads. Do NOT use for giveaway/audience-growth strategy across tools (use /sales-audience-growth), generic iPaaS wiring (use /sales-integration), or email deliverability (use /sales-deliverability). |
| argument-hint | [describe what you need help with in ShortStack] |
| license | MIT |
| version | 1.0.0 |
| tags | ["sales","audience-growth","giveaway","platform"] |
ShortStack Platform Help
Step 1 — Gather context
If references/learnings.md exists, read it first for accumulated platform knowledge.
-
What are you trying to do?
- A) Read entries/leads via the Entries API (paging, newest-first)
- B) Receive entries in real time via the signed webhook (and verify
X-Ss-Signature)
- C) Sync entrants to an ESP/CRM (Mailchimp/HubSpot/Salesforce) or Zapier
- D) Pick + set up a campaign type — contest, sweepstakes, quiz, refer-a-friend, instant-win, hashtag/comment-to-enter
- E) Handle giveaway fraud / fake entries, or pick a winner fairly
- F) Decide Free vs a paid tier, or export leads
-
API or no-code? Code integration → Entries API + signed webhooks. No endpoint → native ESP/CRM connectors or Zapier.
Skip-ahead rule: if the user's prompt already provides enough context, skip to Step 2.
Step 2 — Route or answer directly
| If the question is about... | Route to... |
|---|
| Giveaway / audience-growth strategy across tools (which tool, viral mechanics) | /sales-audience-growth {question} |
| Connecting ShortStack to a CRM/ESP generically (iPaaS) | /sales-integration {question} |
| Email sequences for the list you collect | /sales-email-marketing {question} |
| Deliverability of giveaway/notification emails | /sales-deliverability {question} |
When routing, give the exact command, e.g. "This is a strategy question — run: /sales-audience-growth maximize entries on a refer-a-friend contest".
Step 3 — ShortStack platform reference
Read references/platform-guide.md for the full reference — the campaign-type + module map (what's API vs webhook vs UI-only), the entry/lead data model, plan tiers, and quick-start recipes (pull entries via the API; verify the signed webhook; sync to an ESP).
Read references/shortstack-api-reference.md for the integration surface — the Entries API (base https://entries.shortstack.com/entries, Authorization: Token token= header, ≤5000, /, response) and the ( = HMAC of request body + your secret key) that fires on each new entry, plus the Webhooks management API + sandbox.
