| name | sales-sweepwidget |
| description | SweepWidget (sweepwidget.com) platform help — giveaway, contest, and sweepstakes builder with 100+ entry methods across 30+ social platforms, viral refer-a-friend, leaderboards, instant rewards/coupons, and list capture. Developer surface: a read+write REST API (base sweepwidgetapi.com/sw_api/, Bearer or api_key auth, 50 rows/page via page_start) for users/entries/winners/giveaways plus create-giveaway and entry-method endpoints, and HMAC-SHA256 signed webhooks (X-SweepWidget-Signature; entry_submitted/task_completed/all_entries_completed) — both Enterprise-plan-gated. Use when pulling entries or winners into a CRM or warehouse via the API, verifying the signed webhook, syncing entrants to an ESP or Zapier, an entry is flagged by anti-spam, honor-system entries cannot be verified, the free plan hides entrant data past 10 users, or choosing a plan. Do NOT use for giveaway/audience-growth strategy across tools (use /sales-audience-growth) or deliverability of the collected list (use /sales-deliverability). |
| argument-hint | [describe what you need help with in SweepWidget] |
| license | MIT |
| version | 1.0.0 |
| tags | ["sales","email-marketing","giveaway","platform"] |
| github | https://github.com/SweepWidget |
SweepWidget 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 / winners / users via the REST API (paging with
page_start)
- B) Receive entries in real time via the signed webhook (and verify
X-SweepWidget-Signature)
- C) Create or update a giveaway / entry method programmatically
- D) Sync entrants to an ESP/CRM (Mailchimp etc.) or Zapier
- E) An entry got flagged by the anti-spam system, or honor-system entries can't be verified
- F) Decide a plan (Free vs Pro vs Business vs Premium vs Enterprise), or export entrant data
-
Which plan are you on? The API and server-side webhooks are Enterprise-only — if you're below Enterprise, code integration isn't available; use native ESP connectors, Zapier, or the client-side JavaScript callbacks instead.
Skip-ahead rule: if the user's prompt already contains 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 SweepWidget to a CRM/ESP generically (iPaaS) | /sales-integration {question} |
| Email sequences for the list you collect | /sales-email-marketing {question} |
| Deliverability / list quality of giveaway 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 — SweepWidget platform reference
Read references/platform-guide.md for the full reference — the module map (what's API vs webhook vs UI-only), plan gates, the entry/giveaway data model (JSON shapes), and quick-start recipes (pull entries via the API; verify the signed webhook; sync to an ESP).
Read references/sweepwidget-api-reference.md for the integration surface — base URL , (or param) auth, read endpoints (, , , , ), write endpoints (, , , ), pagination at , and the HMAC-SHA256 signed webhook ().
