Endpoint reference.

Per-endpoint reference for all shipped v0 endpoints. Grouped by resource: accounts, signals, briefs, decision-makers, saved searches, archetypes. Example request + response per endpoint.

Time: 10 min·Updated: 2026-05-25·Audience: developers building integrations

TL;DR

23 endpoints across 6 resources. Accounts: list/get/create/update. Signals: list/get with filters. Briefs: list/get (write via UI only in v0). Decision-makers: list per account. Saved searches: list/get. Archetypes: list/get/recent-replies. All endpoints assume the auth + format conventions from Overview.

01Accounts

GET/v0/accounts

List accounts in your workspace. Supports filtering by ICP score, signal presence, saved-list membership.

Query params: min_fit_score, has_active_signal, list_id, cursor, limit (default 50, max 100).

GET/v0/accounts/{id}

Get a single account with full details: firmographic data, tech stack, current signals, decision-maker count, archetype match.

POST/v0/accounts

Create a new account in your workspace. Supply domain or LinkedIn URL — Mama enriches the rest.

Body: {"domain": "example.com"} or {"linkedin_url": "..."}.

PATCH/v0/accounts/{id}

Update account metadata. Most fields are Mama-managed (you can't override the enrichment); editable fields: tags, notes, owner_id, list_ids.

DELETE/v0/accounts/{id}

Remove an account from your workspace. Underlying data stays in the database (Mama doesn't lose accounts) but it's removed from your saved view.

02Signals

GET/v0/signals

List signals across all your accounts. Filter by type, freshness, account ID, combo-only.

Query params: type (funding/hiring/exec_move/tech_change/etc.), min_freshness_days, account_id, combo_only=true, cursor, limit.

GET/v0/signals/{id}

Get a single signal with full detail: type, sub-type, source, source URL, detection timestamp, freshness band, related signals on the same account.

03Briefs

GET/v0/briefs

List briefs generated in your workspace. Filter by account, date range, owner.

GET/v0/briefs/{id}

Get a full brief with all sections: headline, signals, decision-makers, voice quotes, suggested templates, lookalikes.

Note: brief generation via API is not in v0. Generate briefs via the UI or via Push center signal rules.

04Decision-makers

GET/v0/accounts/{id}/decision-makers

List decision-makers for an account, ranked by role tier × thread-readiness. Includes verified emails where available.

Query params: min_role_tier (1-3), verified_email_only=true.

GET/v0/decision-makers/{id}

Get a single decision-maker with full detail: title, role tier, recent activity, verified email status, thread status (if CRM connected).

05Saved searches

GET/v0/saved-searches

List your saved searches with their last-run stats.

GET/v0/saved-searches/{id}

Get a single saved search with its query definition, alert config, and most recent matches.

06Archetypes

GET/v0/archetypes

List archetypes in your workspace, ranked by member count and reply rate.

GET/v0/archetypes/{id}

Get archetype detail: signal fingerprint, persona shape, member accounts, reply rate, confidence score, sub-archetype proposals.

GET/v0/archetypes/{id}/recent-replies

List recent classified replies attributed to this archetype. Useful for "is this archetype getting noisier?" diagnostics.

Was this page helpful?

Yes No Report unclear