CrowdFundWith API Reference

CrowdFundWith is an API-first subscription crowdfunding platform. Every action available in the dashboard is also available via the REST API — create projects, manage backers, post updates, and handle payments entirely programmatically.

{
  "error": "Project not found",
  "status": 404
}

Authenticating Requests

After registering you receive a single API key prefixed cfw_. Pass it in the x-api-key request header on every call that requires authentication.

curl https://api.crowdfundwith.com/api/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com","name":"Your Name"}'

const res = await fetch('https://api.crowdfundwith.com/api/auth/register', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    email: 'you@example.com',
    name:  'Your Name'
  })
});
const { creator_id, api_key } = await res.json();
// Store api_key immediately — it won't be shown again

import requests

resp = requests.post(
    "https://api.crowdfundwith.com/api/auth/register",
    json={"email": "you@example.com", "name": "Your Name"}
)
data = resp.json()
print(data["api_key"])  # store this!

{
  "creator_id": "crt_a1b2c3d4",
  "api_key":    "cfw_live_xxxxxxxxxxxxxxxxxxxx",
  "message":   "Account created. Save your API key — it won't be shown again."
}

{
  "onboarding_url": "https://connect.stripe.com/setup/e/acct_xxx/..."
}

{
  "connected":        true,
  "payouts_enabled":  true,
  "details_submitted": true
}

Projects

A project is the core resource — it represents your campaign. Backers commit monthly to support a project. All project endpoints require authentication.

curl https://api.crowdfundwith.com/api/projects \
  -H "x-api-key: cfw_your_key" \
  -H "Content-Type: application/json" \
  -d '{"title":"My Indie Game","description":"A pixel RPG...","category":"games","goal_amount":100000}'

const project = await fetch('https://api.crowdfundwith.com/api/projects', {
  method:  'POST',
  headers: { 'x-api-key': API_KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    title:        'My Indie Game',
    description:  'A pixel RPG built with love.',
    category:     'games',
    goal_amount:  100000  // $1,000 CAD/month
  })
}).then(r => r.json());

{
  "project_id":   "prj_x7k2m9",
  "title":        "My Indie Game",
  "category":     "games",
  "goal_amount":  100000,
  "status":       "draft",
  "created_at":   "2025-03-20T14:00:00.000Z"
}

curl https://api.crowdfundwith.com/api/projects \
  -H "x-api-key: cfw_your_key"

curl https://api.crowdfundwith.com/api/projects/prj_x7k2m9 \
  -H "x-api-key: cfw_your_key"

{ "deleted": true }

Updates

Updates are creator posts visible to backers. Think of them as a private blog attached to your project. All update endpoints require authentication.

curl https://api.crowdfundwith.com/api/updates \
  -H "x-api-key: cfw_your_key" \
  -H "Content-Type: application/json" \
  -d '{"project_id":"prj_x7k2m9","title":"Week 1 Update","content":"We shipped the alpha!"}'

{ "deleted": true }

Tiers

Tiers are the monthly commitment levels backers can choose. You set the amount and what backers receive at each level. A project can have multiple tiers.

curl https://api.crowdfundwith.com/api/tiers \
  -H "x-api-key: cfw_your_key" \
  -H "Content-Type: application/json" \
  -d '{"project_id":"prj_x7k2m9","name":"Supporter","amount":700,"description":"Early access to updates"}'

Messages

Send messages to your backers — either broadcast to everyone on a project, or directly to a single backer. Messages are delivered in-app and optionally by email.

curl https://api.crowdfundwith.com/api/messages/broadcast \
  -H "x-api-key: cfw_your_key" \
  -H "Content-Type: application/json" \
  -d '{"project_id":"prj_x7k2m9","content":"We just hit our first milestone!"}'

{
  "sent":       true,
  "recipients": 47
}

Stats

Stats endpoints give you a real-time view into your campaign performance — backer counts, monthly revenue, and churn.

{
  "total_projects":       3,
  "total_backers":        142,
  "monthly_revenue_cad":  318500,  // in cents = $3,185
  "active_subscriptions": 138,
  "churn_last_30d":       4
}

{
  "project_id":          "prj_x7k2m9",
  "backers":             47,
  "monthly_revenue_cad":  98700,
  "goal_amount":         100000,
  "goal_progress_pct":   98.7,
  "tiers": [
    { "name": "Supporter", "amount": 700,  "backers": 31 },
    { "name": "Patron",    "amount": 1400, "backers": 12 },
    { "name": "Champion",  "amount": 2100, "backers": 4  }
  ]
}

Commitment Tiers & Fee Structure

CrowdFundWith uses a tiered commitment model. Creators choose a monthly subscription tier — the higher the commitment, the lower the platform fee. All amounts are in Canadian dollars (CAD).

Using with Claude Code

CrowdFundWith is designed to be managed entirely from the terminal. The API is clean enough that you can run a full campaign through Claude Code — no dashboard required. Below is a starter workflow you can paste directly into a Claude Code session.

# Step 1 — Register and save your API key
curl -X POST https://api.crowdfundwith.com/api/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com","name":"Your Name"}'

# Step 2 — Create your project
curl -X POST https://api.crowdfundwith.com/api/projects \
  -H "x-api-key: $CFW_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"My Project","description":"What I am building...","category":"technology"}'

# Step 3 — Add commitment tiers
curl -X POST https://api.crowdfundwith.com/api/tiers \
  -H "x-api-key: $CFW_KEY" \
  -H "Content-Type: application/json" \
  -d '{"project_id":"prj_xxx","name":"Supporter","amount":700,"description":"Access to updates"}'

# Step 4 — Publish the project
curl -X PUT https://api.crowdfundwith.com/api/projects/prj_xxx \
  -H "x-api-key: $CFW_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status":"published"}'

# Step 5 — Post a Week 1 update
curl -X POST https://api.crowdfundwith.com/api/updates \
  -H "x-api-key: $CFW_KEY" \
  -H "Content-Type: application/json" \
  -d '{"project_id":"prj_xxx","title":"Week 1 Update","content":"Here is what we shipped..."}'

# Step 6 — Check your dashboard stats
curl https://api.crowdfundwith.com/api/stats/dashboard \
  -H "x-api-key: $CFW_KEY"

# Step 7 — Broadcast a message to all backers
curl -X POST https://api.crowdfundwith.com/api/messages/broadcast \
  -H "x-api-key: $CFW_KEY" \
  -H "Content-Type: application/json" \
  -d '{"project_id":"prj_xxx","content":"Thank you for your support this month!"}'

Webhooks

CrowdFundWith handles Stripe webhook events automatically at POST /webhooks/stripe. You do not need to build your own Stripe integration — the platform handles subscription lifecycle events on your behalf.

Handled Stripe Events

stripe listen \
  --forward-to http://localhost:3000/webhooks/stripe \
  --events checkout.session.completed,customer.subscription.deleted,invoice.payment_failed

AI Campaign Builder

Not sure how to describe your project? The AI Campaign Builder takes a short brief from you and generates everything — project title, description, tiers, milestones, and a launch update — ready to publish.