Skip to main content

API reference

All operations: Dialer

Every Dialer and Sales operation.

Generated from the API's OpenAPI spec, so it always matches what the API serves.

Dialer sessions, analytics, follow-ups and lead briefs, and Sales AI plays, drafts and threads. Sales AI is switched on per organization.

Generated from the API's OpenAPI spec: 17 operations. Request and response bodies for each are in the API reference. The MCP tool column names the tool in Finn's MCP server that makes the same call.

Dialer

EndpointWhat it doesScopeMCP toolNotes
GET /dialer/sessionsList dialer sessionsdialer:readlist_rep_sessionscursor pages
GET /dialer/sessions/{id}Get a dialer sessiondialer:readget_rep_session
GET /dialer/analyticsDialer analyticsdialer:readget_rep_analytics
GET /dialer/follow-upsList dialer follow-upsdialer:readlist_rep_follow_ups
GET /dialer/leads/{id}/briefGet a lead's cached briefdialer:readget_lead_brief
POST /dialer/follow-ups/{call_id}/doneMark a dialer follow-up donedialer:writedialer_mark_follow_up_doneIdempotency-Key
PUT /dialer/calls/{call_id}/dispositionSet a finished call's dispositiondialer:writedialer_set_dispositionIdempotency-Key
POST /dialer/calls/{call_id}/notesAdd a note to a finished calldialer:writedialer_add_call_noteIdempotency-Key

Sales

EndpointWhat it doesScopeMCP toolNotes
GET /sales/playsList Sales AI playssales:readlist_sales_plays
GET /sales/plays/{slug}/runsList a play's runssales:readlist_sales_play_runs
GET /sales/plays/{slug}/prospectsList a play's prospectssales:readlist_sales_prospectscursor pages
POST /sales/plays/{slug}/runRun a playsales:writerun_sales_playIdempotency-Key; can be held: 202 pending_approval
GET /sales/draftsList draftssales:readlist_sales_draftscursor pages
PATCH /sales/drafts/{id}Edit a draftsales:writeedit_sales_draft
POST /sales/drafts/{id}/skipSkip a draftsales:writeskip_sales_draftIdempotency-Key
GET /sales/threadsList threadssales:readlist_sales_threadscursor pages
GET /sales/threads/{id}Get a threadsales:readread_sales_thread