Marketing platform for creating campaigns, submitting proofs, and reviewing submissions.
Captured live from the server via tools/list.
getPricing
Get the market-rate pricing for a marketing action. Returns USD value and recommended perk type/value.
Parameters (3)
actionIdstring
Action ID (e.g. ig_post, google_review)
platformIdstring
Platform ID (e.g. instagram, google)
businessTypestring
Business type modifier (default: general)
listActions
List the 107 marketing actions available on Social Perks. Filterable by platform, type, and effort.
Parameters (5)
platformIdstring
typestring
maxEffortinteger
pageinteger
perPageinteger
getBenchmarks
Get industry benchmarks (engagement rate, conversion rate, etc.).
Parameters (1)
industrystring
listCampaigns
List campaigns. Requires auth — returns the caller's campaigns.
Parameters (1)
statusstring
searchInfluencers
Search influencers by platform and follower count.
Parameters (2)
platformstring
minFollowersinteger
createCampaign
Create and launch a new campaign for the calling business. Returns the campaign id, name, and dashboard URL. The campaign goes live immediately — no separate publish step.
Parameters (8)
businessIdstringrequired
The business owning this campaign. Must match the API key's business.
namestringrequired
Customer-facing campaign name
descriptionstring
Optional internal description
actionsarrayrequired
Action IDs the campaign accepts (e.g. ['ig_st'] for an Instagram Story Tag).
discountValuenumberrequired
Discount amount. Capped at 100 for pct, 10000 for dol.
discountTypestringrequired
Discount denomination: 'pct' for percentage, 'dol' for dollars off.
maxCompletionsinteger | null
Optional cap on total completions. Null = no cap.
expiresInDaysinteger
Days until the campaign auto-expires. Default 60.
submitProof
Submit proof of completion for a campaign action — a public URL to a post, a screenshot, a video, or platform-verified data. The submission enters a review queue (or auto-approves depending on the campaign's verification mode).
Parameters (5)
campaignIdstringrequired
Campaign the submission applies to.
actionIdstringrequired
Specific action being completed (must be allowed by the campaign).
proofUrlstringrequired
Public URL of the proof. For url-type submissions, the platform verifier will fetch this.
proofTypestringrequired
How the proof was captured. 'url' triggers automated verification.
metadataobject
Optional bag of context (poster handle, post timestamp, etc.).
reviewSubmission
Approve or reject a submission. Approving releases the perk; rejecting requires a reason. Use this when the business chooses manual review over auto-verification.
Parameters (3)
submissionIdstringrequired
Submission id from a prior submitProof call.
decisionstringrequired
Approve releases the perk. Reject explains why the proof was insufficient.
reasonstring
Required when decision='reject'. 1-500 chars.
listSubmissions
List submissions for a business or campaign, filterable by state (pending/approved/rejected). Returns paginated results.
Parameters (5)
businessIdstring
campaignIdstring
statestring
pageinteger
perPageinteger
getCampaignStats
Get summary stats for a single campaign — total submissions, approved count, conversion rate, perks issued, and time-to-first-submission. Useful for an agent reporting back to its user.
This project includes a CLAUDE.md file that gives Claude Code full context about the architecture, design system, and what needs building next. Just run:
bash
claude
in the project directory and Claude will understand the full codebase.
