Provision client accounts, deploy snapshots, sync deals, and pull commission data programmatically. The API is in private beta — we're opening it to higher-grade partners first. Endpoints below are a preview and may change.
Base URL: https://api.mosco.ai/v1/partners
Six capability areas. Mix-and-match to fit your agency, white-label SaaS, or custom integrations.
Create, suspend, and reactivate Mosco accounts on behalf of your clients. Auto-apply your branding and default snapshots.
Push your own marketplace snapshots to any client account. Roll updates out to all clients in one call.
Pull lead activity, deal stage changes, and pipeline metrics into your existing CRM, spreadsheets, or BI.
Real-time commission events. Pipe to your accounting system, payroll, or partner-of-partner attribution.
13 event types for client lifecycle, payouts, and certification milestones. Signed with HMAC-SHA256.
Pull the audit trail for every action your team or API tokens performed across client accounts.
Once the partner portal is live, you'll generate scoped API keys from Settings → API. Each key is bound to one or more client accounts and can be revoked instantly.
# Authenticate every request with your partner key
curl https://api.mosco.ai/v1/partners/me \
-H "Authorization: Bearer mosco_pk_live_••••" \
-H "Content-Type: application/json"
# Response
{
"partner_id": "ptr_8gh4k2",
"company": "Castells Media",
"grade": "silver",
"scopes": ["clients:read", "clients:write", "snapshots:deploy"]
}/clients/clients/{id}/clients/{id}/snapshots/deals/deals/commissions/payouts/upcoming/affiliate-links/snapshotsFull reference + interactive playground available after onboarding.
Apply for API accessclient.createdclient.activatedclient.suspendedclient.churneddeal.registereddeal.stage_changeddeal.woncommission.accruedpayout.scheduledpayout.paidsnapshot.deployedsnapshot.purchasedtier.changedEvery payload is signed with X-Mosco-Signature using HMAC-SHA256 of your webhook secret.
POST https://your-app.com/hooks/mosco
X-Mosco-Signature: t=1733260800,v1=a2114d57b4...
{
"id": "evt_8c2f1d",
"type": "deal.won",
"created": 1733260800,
"data": {
"deal_id": "deal_4k9m2n",
"client_id": "cli_a8j3p1",
"company": "Aspen HVAC Co",
"plan": "pro",
"mrr_cents": 49900,
"partner_id": "ptr_8gh4k2",
"first_commission_cents": 14970
}
}