Meeting Results meeting_results
Meetings Kenso booked for a pay-per-meeting workspace: list, proof, add, no-show, dispute, escalate, possible meetings
Call it from an MCP client connected to https://mcp.ken.so/mcp: reads go through meeting_results_read and changes through meeting_results_write. Each takes operation plus that operation's parameters, and your workspace role decides which operations you see.
Each operation with a route calls the Kenso API at https://api.ken.so with Authorization: Bearer <Kenso API key>, Ken-Version: 1.1 and X-Ken-Workspace-Id: <workspace id>. You can call that route directly with the same headers.
Operations: hints-convert, create, hints-dismiss, dispute, escalate, get, hints-list, list, no-show, summary
hints-convert
Write. POST https://api.ken.so/v1/meeting-result-hints/{hintId}/conversions
Path: hintId
Body (json): note string, scheduledAt date-time, scheduledEndAt date-time
Convert a possible meeting into a meeting result for its contact. Only on the user's request. Needs Meetings view, the Billing feature and the meeting_results flag.
POST /api/v1/meeting-result-hints/{hintId}/conversions. Internal. Sends Ken-Version 1.1 and
X-Ken-Actor: agent. Adds the meeting as meeting_results(operation="create", ...) does, with
the hint's contact as the attendee, and the same checks; adding it counts as the client's
confirmation that it happened. Kenso decides with its usual rules whether its outreach
sourced it. A retry never adds a second meeting.
Args:
hint_id: the hint's id from meeting_results(operation="hints-list").
scheduled_at: when the meeting is or was, ISO-8601 with an offset
(2026-10-20T15:00:00Z), from 60 days ago to 365 days ahead.
scheduled_end_at: when it ends, after scheduled_at.
note: at most 1000 characters, kept on the meeting's timeline.
Returns the hint, status converted, with convertedResultId. 409 conflict when the hint is
not open or its contact is gone; 409 not_on_performance_deal when the workspace has no
pay-per-meeting deal; not_found for a hint of another workspace.
create
Write. POST https://api.ken.so/v1/meeting-results
Body (json): attendeeEmail string, attendeeLinkedInUrl string, attendeeName string, companyName string, note string, scheduledAt date-time, scheduledEndAt date-time
Add a meeting Kenso could not see (a call, an in-person meeting); Kenso decides whether its outreach sourced it. Needs Meetings view, the Billing feature and the meeting_results flag.
POST /api/v1/meeting-results. Internal. Sends Ken-Version 1.1 and X-Ken-Actor: agent.
Adding a meeting counts as the client's confirmation that it happened. Kenso applies the
same attribution rules as to every other source. Needs a credential tied to a person: a
workspace API key without one gets forbidden.
Args:
scheduled_at: when the meeting is or was, ISO-8601 with an offset
(2026-10-20T15:00:00Z), from 60 days ago to 365 days ahead.
attendee_email, attendee_linkedin_url, attendee_name: who attended. Give at least
one; the email matches best.
company_name: the attendee's company.
scheduled_end_at: when it ends, after scheduled_at.
note: at most 1000 characters, kept on the meeting's timeline.
idempotency_key: at most 193 characters. A retry with the same key and scheduled_at
returns the stored meeting without adding another; the key on another meeting
fails with 422 idempotency_key_reused. Without a key every call adds a meeting,
so pass one when a retry is possible.
Returns 201 with the meeting (as meeting_results(operation="get") without events) when
Kenso credits it; 200 with the meeting when Kenso already had it; 202 with
{"attribution": "pending_review"|"not_ours"} when it was recorded but is not credited to
Kenso, so it is not listed. 409 not_on_performance_deal when the workspace has no
pay-per-meeting deal.
hints-dismiss
Write. POST https://api.ken.so/v1/meeting-result-hints/{hintId}/dismissals
Path: hintId
Dismiss a possible meeting that did not turn into a meeting. Only on the user's request. Needs Meetings view, the Billing feature and the meeting_results flag.
POST /api/v1/meeting-result-hints/{hintId}/dismissals. Internal. Sends Ken-Version 1.1 and
X-Ken-Actor: agent. The hint becomes dismissed; nothing else changes.
Args:
hint_id: the hint's id from meeting_results(operation="hints-list").
Returns the hint, status dismissed. 409 conflict when it is not open; not_found for a hint
of another workspace.
dispute
Write. POST https://api.ken.so/v1/meeting-results/{meetingResultId}/disputes
Path: meetingResultId
Body (json): note string, reason string
Dispute a Kenso-booked meeting the workspace should not pay for; Kenso staff decide. Only on the user's request. Needs Meetings view, the Billing feature and the meeting_results flag.
POST /api/v1/meeting-results/{meetingResultId}/disputes. Internal. Sends Ken-Version 1.1
and X-Ken-Actor: agent. Allowed while actions.canDispute is true. The meeting is not billed
while the dispute is open.
Args:
reason: not_icp, non_buyer (a competitor, vendor, job seeker, student or investor),
existing_relationship, duplicate_account, false_premise, not_our_outreach or
internal_attendee. After the dispute window only existing_relationship,
duplicate_account and internal_attendee are accepted, for a limited time.
note: why, 1 to 1000 characters. Kenso staff read it.
Returns the updated meeting with "dispute". validation_failed (detail invalid_state) or
409 conflict when the meeting cannot be disputed, 409 window_closed when the window closed;
not_found for a meeting not credited to Kenso.
escalate
Write. POST https://api.ken.so/v1/meeting-results/{meetingResultId}/escalations
Path: meetingResultId
Body (json): note string
Escalate a rejected dispute to a second Kenso review. Only on the user's request. Needs Meetings view, the Billing feature and the meeting_results flag.
POST /api/v1/meeting-results/{meetingResultId}/escalations. Internal. Sends Ken-Version 1.1
and X-Ken-Actor: agent. Allowed while actions.canEscalate is true: Kenso rejected the
dispute, it was not escalated before, and the escalation window after the decision is open.
Args:
note: why the decision is wrong, 1 to 1000 characters.
Returns the updated meeting with "escalation". validation_failed (detail invalid_state) or
409 conflict when it cannot be escalated, 409 window_closed when the window closed;
not_found for a meeting not credited to Kenso.
get
Read. GET https://api.ken.so/v1/meeting-results/{meetingResultId}
Path: meetingResultId
Get one Kenso-booked meeting with its proof and its timeline of events. Needs Meetings view and the meeting_results flag.
GET /api/v1/meeting-results/{meetingResultId}. Internal. Sends Ken-Version 1.1 and
X-Ken-Actor: agent.
Returns the meeting as meeting_results(operation="list") does, plus "events": [{"type",
"occurredAt", "actor", "payload"}], oldest first. not_found for a meeting that is not in
the workspace or not credited to Kenso.
hints-list
Read. GET https://api.ken.so/v1/meeting-result-hints
Query: limit integer, status string
List possible meetings: replies asking for a meeting from a contact with no meeting result yet. Needs Meetings view and the meeting_results flag.
GET /api/v1/meeting-result-hints. Internal. Sends Ken-Version 1.1 and X-Ken-Actor: agent.
A hint is never a meeting on its own: the meeting may have happened somewhere Kenso cannot
see (a call, an in-person meeting). Convert it with
meeting_results(operation="hints-convert", ...) once the meeting is known, or dismiss it
with meeting_results(operation="hints-dismiss", ...).
Args:
status: open, converted or dismissed. Absent lists every status.
limit: 1 to 200, default 50. There is no cursor: pagination.hasMore is true when more
hints match than the limit.
Returns {"success": true, "data": [{"id", "channel" (email or linkedin), "detectedAt"
(when the reply came in), "status", "contact": {"id", "email", "name", "companyName"},
"threadRef" (the conversation's thr_ id), "convertedResultId"}], "pagination":
{"hasMore"}}, newest reply first.
list
Read. GET https://api.ken.so/v1/meeting-results
Query: billable boolean, cursor string, limit integer, month string, status string
List the meetings Kenso booked for this workspace (pay-per-meeting), newest first, with what each one can still do. Needs Meetings view and the meeting_results flag.
GET /api/v1/meeting-results. Internal. Sends Ken-Version 1.1 and X-Ken-Actor: agent.
Only meetings credited to Kenso's outreach; meetings under review or not credited are not
listed.
Args:
status: one status or several, comma-separated (OR): booked, held, no_show,
rescheduled, cancelled, disputed, awaiting_client, cancelled_by_prospect,
cancelled_by_client or rep_no_show.
month: YYYY-MM, the UTC month the meeting is or was in.
billable: true for billable meetings only, false for the rest.
limit: 1 to 200, default 50.
cursor: pagination.nextCursor from the previous page.
Returns {"success": true, "data": [{"id", "source", "status", "scheduledAt",
"scheduledEndAt", "originalScheduledAt", "bookedAt", "attendee": {"email", "name",
"domain"}, "matchKind", "lastTouch": {"at", "channel", "campaignId", "stepOrder"},
"windowDays", "heldEvidence", "disputeDeadlineAt", "dispute", "escalation", "billable",
"billableAt", "billingMonth", "creditedAt", "creditNote", "chainRootId",
"replacesResultId", "actions": {"canMarkNoShow", "canDispute", "canEscalate"}}],
"pagination": {"nextCursor", "hasMore"}}. validation_failed names the bad field.
no-show
Write. POST https://api.ken.so/v1/meeting-results/{meetingResultId}/no-show
Path: meetingResultId
Body (json): note string
Mark a Kenso-booked meeting as a no-show, so it is not billed. Only on the user's request. Needs Meetings view, the Billing feature and the meeting_results flag.
POST /api/v1/meeting-results/{meetingResultId}/no-show. Internal. Sends Ken-Version 1.1
and X-Ken-Actor: agent. Allowed while actions.canMarkNoShow is true: the meeting time has
passed, the meeting is booked, awaiting the client or held, it is not settled, disputed
or escalated, and its dispute window is open.
Args:
note: at most 1000 characters.
Returns the updated meeting. validation_failed (detail invalid_state) or 409 conflict when
the meeting's state does not allow it, 409 window_closed when its window closed; not_found
for a meeting not credited to Kenso.
summary
Read. GET https://api.ken.so/v1/meeting-results/summary
Query: month string
Count one month of Kenso-booked meetings: attributed, held, no-show, cancelled, disputed, billable. Needs Meetings view and the meeting_results flag.
GET /api/v1/meeting-results/summary. Internal. Sends Ken-Version 1.1 and X-Ken-Actor: agent.
Args:
month: YYYY-MM. Absent is the current month in the deal's time zone. Meetings count
in the UTC month they are or were in.
Returns {"success": true, "data": {"month", "attributedCount", "heldCount",
"noShowCount", "cancelledByProspectCount", "cancelledByClientCount", "cancelledCount",
"disputedCount", "disputesUpheldCount", "billableCount", "awaitingClientCount"}}. All zeros
for a month with no meetings.