API reference.

Authorization: Bearer sa_live_your_key_here

# Create an app. The returned id (app_…) is what you target everywhere.
curl -X POST https://api.startupaid.org/v1/apps \
  -H "Authorization: Bearer sa_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Acme" }'
# => { "id": "app_9f3k2x8a1b2c3d4e5f6a", "name": "Acme", "createdAt": "…" }

# List your apps
curl https://api.startupaid.org/v1/apps \
  -H "Authorization: Bearer sa_live_xxx"

curl -X POST https://api.startupaid.org/v1/send \
  -H "Authorization: Bearer sa_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "hello@yourdomain.com",
    "to": "user@example.com",
    "subject": "Welcome aboard",
    "body": "<h1>Hi there 👋</h1><p>Thanks for signing up.</p>"
  }'

# => 202 Accepted
# { "id": "…", "status": "queued", "to": "user@example.com" }

import nodemailer from "nodemailer";

const transport = nodemailer.createTransport({
  host: "smtp.startupaid.org",
  port: 587,
  secure: false,                 // STARTTLS is negotiated on 587
  auth: { user: "apikey", pass: "sa_live_your_key" },
});

await transport.sendMail({
  from: "hello@yourdomain.com",  // a verified domain
  to: "user@example.com",
  subject: "Hello from SMTP",
  html: "<h1>Hi 👋</h1>",
});

curl -X POST https://api.startupaid.org/v1/send \
  -H "Authorization: Bearer sa_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "hello@yourdomain.com",
    "to": "user@example.com",
    "template": "welcome_onboarding",
    "variables": { "name": "Alex", "plan": "Founder" }
  }'

curl -X POST https://api.startupaid.org/v1/send \
  -H "Authorization: Bearer sa_live_xxx" \
  -H "Idempotency-Key: order-4192-receipt" \
  -H "Content-Type: application/json" \
  -d '{ "from": "hello@yourdomain.com", "to": "user@example.com",
        "subject": "Receipt", "body": "<p>Thanks!</p>" }'

curl https://api.startupaid.org/v1/messages/MESSAGE_ID \
  -H "Authorization: Bearer sa_live_xxx"

# => {
#   "id": "…", "to": "user@example.com",
#   "status": "delivered",   // queued | sending | sent | delivered | failed
#   "attempts": 1, "createdAt": "…"
# }

curl -X POST https://api.startupaid.org/v1/audiences \
  -H "Authorization: Bearer sa_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Newsletter", "description": "Weekly product updates" }'

# => { "id": "AUDIENCE_ID", "name": "Newsletter", "contactCount": 0, ... }

curl -X POST https://api.startupaid.org/v1/audiences/AUDIENCE_ID/contacts \
  -H "Authorization: Bearer sa_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "ada@example.com",
    "firstName": "Ada",
    "lastName": "Lovelace",
    "data": "{\"plan\": \"pro\"}"
  }'
# => { "id": "…", "email": "ada@example.com", "subscribed": true, ... }

# Flip a contact's subscription state
curl -X PATCH https://api.startupaid.org/v1/contacts/CONTACT_ID \
  -H "Authorization: Bearer sa_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "subscribed": false }'

# Fiat, crypto, or a mix, from/to any supported code.
curl "https://api.startupaid.org/v1/convert?from=USD&to=NGN&amount=100" \
  -H "Authorization: Bearer sa_live_xxx"

# => {
#   "from": "USD", "to": "NGN", "amount": 100,
#   "result": 137503.95,
#   "rateAsOf": "2026-07-09T00:00:00Z"   // freshness of THIS pair
# }

# Crypto works the same way:
curl "https://api.startupaid.org/v1/convert?from=BTC&to=USD&amount=1" \
  -H "Authorization: Bearer sa_live_xxx"
# => { "result": 63837.0, "rateAsOf": "2026-07-10T08:11:23Z" }

# If you've set a CUSTOM rate on the pair, the response also gives you the
# market rate and your margin, so fintechs book profit with no extra math:
# => {
#   "result": 160000, "rate": 1600,            // at your rate
#   "marketRate": 1375.04, "marketResult": 137503.95,
#   "spread": { "rate": 224.96, "percent": 16.36, "amount": 22496.05 }
# }

curl "https://api.startupaid.org/v1/currencies" \
  -H "Authorization: Bearer sa_live_xxx"

# => { "currencies": [
#   { "code": "USD", "type": "fiat" },
#   { "code": "NGN", "type": "fiat" },
#   { "code": "BTC", "type": "crypto", "name": "Bitcoin", "logo": "https://…" },
#   … 100+ total
# ]}

# Register from YOUR backend so the secret key never ships in the app.
# platform: "fcm" (Android/web) · "apns" (iOS) · "webpush" (browser)
curl -X POST https://api.startupaid.org/v1/push/apps/APP_ID/devices \
  -H "Authorization: Bearer sa_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "userRef": "user_42",
    "platform": "fcm",
    "token": "DEVICE_TOKEN"
  }'

# For web push, "token" is the browser PushSubscription JSON (endpoint + keys).

# One call reaches iOS, Android, and web. We fan out to each platform.
curl -X POST https://api.startupaid.org/v1/push/apps/APP_ID/send \
  -H "Authorization: Bearer sa_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "target": { "userRef": "user_42" },
    "title": "Your order shipped 📦",
    "body": "Arriving Tuesday.",
    "link": "acme://orders/8921"
  }'

# target: { userRef } | { userRefs: [...] } | { tokens: [...] } | { all: true }
# => { "messageId": "…", "status": "sent", "recipients": 3, "sent": 3, "failed": 0 }

# Managed: we generate, deliver, and verify the code.
curl -X POST https://api.startupaid.org/v1/otp/send \
  -H "Authorization: Bearer sa_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "to": "+2348012345678", "appId": "app_9f3k2x8a…" }'
# => { "id": "…", "to": "+2348012345678", "status": "pending", "expiresAt": "…" }

# Delivery-only: pass your own code (4–10 letters/digits) and we just deliver it.
curl -X POST https://api.startupaid.org/v1/otp/send \
  -H "Authorization: Bearer sa_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "to": "+2348012345678", "code": "482913" }'

curl -X POST https://api.startupaid.org/v1/otp/verify \
  -H "Authorization: Bearer sa_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "to": "+2348012345678", "code": "482913" }'
# => { "verified": true }

curl https://api.startupaid.org/v1/social/channels \
  -H "Authorization: Bearer sa_live_xxx"

# => { "channels": [
#      { "id": "chan_9f2", "platform": "twitter", "name": "@acme", "active": true },
#      { "id": "chan_7a1", "platform": "youtube", "name": "@acmehq", "active": true } ] }

# Schedule a post to your connected channels (connect them in the dashboard).
# Omit "scheduledFor" to publish as soon as possible.
curl -X POST https://api.startupaid.org/v1/social/schedule \
  -H "Authorization: Bearer sa_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "channels": ["chan_9f2", "chan_7a1"],
    "content": "We just shipped Deep Links 🚀",
    "imageUrl": "https://cdn.acme.io/launch.png",
    "scheduledFor": "2026-07-20T09:00:00Z"
  }'

# => 202 { "id": "post_…", "status": "scheduled", "scheduledFor": "…" }
# Attach a clip instead: "videoUrl": "https://…/take.mp4" (posted natively on
# X, Instagram, Facebook, Threads, YouTube and TikTok; a link elsewhere).
# List posts + per-channel results:  GET /v1/social/posts

curl -X POST https://api.startupaid.org/v1/loyalty/programs \
  -H "Authorization: Bearer sa_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Moses Rewards",
    "tiers": [{ "name": "Bronze", "minPoints": 0 }, { "name": "Gold", "minPoints": 500, "reward": "Free delivery for a year" }],
    "referralPoints": 50, "refereePoints": 20,
    "pointsExpireDays": 365, "pointsPerSpend": 1
  }'
# => { "id": "…", "widgetKey": "wgt_…", "status": "draft", … }

# Programs start as drafts. Activate when the rules are right:
curl -X POST https://api.startupaid.org/v1/loyalty/programs/PROGRAM_ID/status \
  -H "Authorization: Bearer sa_live_xxx" -H "Content-Type: application/json" \
  -d '{ "status": "active" }'

# By count. eventId (or an Idempotency-Key header) makes retries safe.
curl -X POST https://api.startupaid.org/v1/loyalty/programs/PROGRAM_ID/award \
  -H "Authorization: Bearer sa_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "email": "ada@example.com", "points": 25, "reason": "Completed profile", "eventId": "profile:u_123" }'
# => { "contactId": "…", "status": { "balance": 25, "tier": { "name": "Bronze" }, "nextTier": { … } } }

# By activity key, so the value lives in the dashboard, not your code:
curl -X POST https://api.startupaid.org/v1/loyalty/programs/PROGRAM_ID/award \
  -H "Authorization: Bearer sa_live_xxx" -H "Content-Type: application/json" \
  -d '{ "email": "ada@example.com", "activity": "daily_login", "eventId": "login:u_123:2026-09-11" }'

# At the till, by the phone the member added in the widget:
curl -X POST https://api.startupaid.org/v1/loyalty/programs/PROGRAM_ID/award \
  -H "Authorization: Bearer sa_live_xxx" -H "Content-Type: application/json" \
  -d '{ "phone": "+447911123456", "points": 10, "reason": "In-store purchase" }'

# Who is this, and where do they stand?
curl "https://api.startupaid.org/v1/loyalty/programs/PROGRAM_ID/contacts?phone=%2B447911123456" \
  -H "Authorization: Bearer sa_live_xxx"
# => { "contactId": "…", "email": "ada@example.com", "status": { "balance": 340, "tier": { … }, "expiresAt": "…" } }

# What can they spend on?
curl https://api.startupaid.org/v1/loyalty/programs/PROGRAM_ID/rewards -H "Authorization: Bearer sa_live_xxx"
# => { "rewards": [ { "id": "rw_…", "name": "Free coffee", "cost": 50, "kind": "coupon", "stock": -1, … } ] }

# Spend. A coupon reward returns its code right here.
curl -X POST https://api.startupaid.org/v1/loyalty/programs/PROGRAM_ID/redeem \
  -H "Authorization: Bearer sa_live_xxx" -H "Content-Type: application/json" \
  -d '{ "email": "ada@example.com", "rewardId": "rw_…" }'
# => { "redemption": { "code": "CAFE-7K2M9Q4A", "status": "fulfilled", "pointsSpent": 50 }, "status": { "balance": 290 } }

# Your app knows who brought whom. Tell us once; both sides earn what the program promises.
curl -X POST https://api.startupaid.org/v1/loyalty/programs/PROGRAM_ID/referrals \
  -H "Authorization: Bearer sa_live_xxx" -H "Content-Type: application/json" \
  -d '{ "referrerEmail": "moses@example.com", "refereeEmail": "new@example.com" }'
# => { "referrer": { "balance": 50 }, "referee": { "balance": 20 }, "replayed": false }
# A second call for the same new member replays the first: nobody is paid twice.

# A daily check-in QR by the door: 5 points, once every 24 hours, all summer.
curl -X POST https://api.startupaid.org/v1/loyalty/programs/PROGRAM_ID/codes \
  -H "Authorization: Bearer sa_live_xxx" -H "Content-Type: application/json" \
  -d '{ "code": "DOOR", "name": "Door check-in", "pointsValue": 5, "repeatAfterHours": 24, "expiresAt": "2026-09-30T00:00:00Z" }'

# A one-per-person campaign code for the first 500 people:
curl -X POST https://api.startupaid.org/v1/loyalty/programs/PROGRAM_ID/codes \
  -H "Authorization: Bearer sa_live_xxx" -H "Content-Type: application/json" \
  -d '{ "code": "LAUNCH", "pointsValue": 100, "maxRedemptions": 500, "reward": "Launch-day bonus" }'

# Print it: a PNG QR of the code's claim link.
curl https://api.startupaid.org/v1/loyalty/codes/CODE_ID/qr -H "Authorization: Bearer sa_live_xxx"
# => { "dataUrl": "data:image/png;base64,…", "link": "https://www.startupaid.org/claim/wgt_…/DOOR" }

curl -X POST https://api.startupaid.org/v1/events \
  -H "Authorization: Bearer sa_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "type": "purchase", "email": "sam@lumen.dev", "value": 49.00, "currency": "USD", "data": { "plan": "growth" } }'

# => 202 { "id": "…", "type": "purchase", "email": "sam@lumen.dev",
#          "attributed": true, "campaignId": "cmp_…", "touch": "clicked" }
# type: letters, digits, _ or -. value is in major units; omit it for events without one.

# What can I make, and what does it cost?
curl https://api.startupaid.org/v1/video/config \
  -H "Authorization: Bearer sa_live_xxx"

# => { "enabled": true, "maxInFlight": 4,
#      "pricing": { "resolutionPct": { "480p": 70, "720p": 100, "1080p": 150, "4k": 700 }, "refSurcharge": 5 },
#      "models": [ { "id": "seedance", "label": "Seedance", "mode": "text", "perSecond": 14,
#                    "minSecs": 4, "maxSecs": 15, "resolutions": ["480p","720p"], "credits": 56 },
#                  { "id": "kling", "label": "Kling 2.5 Turbo", "mode": "text", "perSecond": 13,
#                    "durations": [5, 10], "resolutions": ["1080p"], "credits": 98 }, … ] }

# Price a clip before making it (nothing is charged):
curl -X POST https://api.startupaid.org/v1/video/quote \
  -H "Authorization: Bearer sa_live_xxx" -H "Content-Type: application/json" \
  -d '{ "model": "seedance", "durationSecs": 8, "resolution": "720p" }'
# => { "credits": 112, "model": "seedance", "durationSecs": 8, "resolution": "720p" }

curl -X POST https://api.startupaid.org/v1/video/jobs \
  -H "Authorization: Bearer sa_live_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: launch-teaser-1" \
  -d '{
    "prompt": "Product on a phone in a sunlit café, slow dolly in, warm light",
    "model": "seedance",
    "durationSecs": 6,
    "aspectRatio": "9:16",
    "resolution": "720p"
  }'

# => 202 { "id": "vid_01a8…", "status": "queued", "creditsCost": 84, "model": "seedance", … }

# Animate a still (image-to-video):
#   "model": "seedance-i2v", "sourceImageUrl": "https://…/hero.png"
# Put a subject in a new scene (element-to-video):
#   "model": "seedance-e2v", "elementImageUrls": ["https://…/founder-1.png", "https://…/founder-2.png"]

curl https://api.startupaid.org/v1/video/jobs/vid_01a8… \
  -H "Authorization: Bearer sa_live_xxx"

# => { "id": "vid_01a8…", "status": "done",
#      "videoUrl": "https://cdn.startupaid.org/video/…/take.mp4",
#      "thumbnailUrl": "https://cdn.startupaid.org/video/…/take.jpg",
#      "creditsCost": 84, "durationSecs": 6, "aspectRatio": "9:16",
#      "autoPost": { "channels": ["chan_7a1"], "postId": "post_…" } }

# Post it to YouTube and TikTok the moment it lands:
curl -X POST https://api.startupaid.org/v1/video/jobs \
  -H "Authorization: Bearer sa_live_xxx" -H "Content-Type: application/json" \
  -d '{
    "prompt": "…", "model": "seedance", "durationSecs": 6, "aspectRatio": "9:16",
    "autoPost": { "channels": ["chan_7a1", "chan_3c9"], "caption": "Sneak peek 👀" }
  }'

curl -X POST https://api.startupaid.org/v1/images/generate \
  -H "Authorization: Bearer sa_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Matte black water bottle on a stone table, soft morning light",
    "model": "seedream",
    "size": "16:9",
    "count": 2
  }'

# => { "credits": 16, "images": [
#      { "id": "img_…", "url": "https://cdn.startupaid.org/image/…/1.png", "width": 1280, "height": 720, "prompt": "…" },
#      { "id": "img_…", "url": "https://cdn.startupaid.org/image/…/2.png", … } ] }

# Edit reference images with a prompt:
#   "model": "nano-banana-edit", "imageUrls": ["https://…/bottle.png"], "prompt": "Add a lime wedge beside it"

curl https://api.startupaid.org/v1/account/ai-credits \
  -H "Authorization: Bearer sa_live_xxx"

# => { "used": 612, "allowance": 1000, "topup": 2000, "remaining": 2388 }
# allowance -1 means unlimited. A request beyond the balance:
# => 402 { "error": "you've used all your AI credits for this month — buy more credits or upgrade your plan" }

Settings → Connectors → Add custom connector

Name:  startupaid
URL:   https://api.startupaid.org/mcp

Claude sends you to startupaid to sign in and approve, then the tools appear
in every chat. Works on claude.ai, the mobile apps and Claude Desktop.