mail:read, meetings:read, meetings:transcript:read and meetings:write, which you grant on the Authorize access page when you connect.
This page is generated from the connector’s tool catalogue. It describes 9 tools. Every tool reads or writes only your own account.
Permissions this page needs
mail:read: Read your outreach templates, thank-you drafts, email delivery jobs, and your outreach settingsmeetings:read: Read your meetings and meeting detailsmeetings:transcript:read: Read meeting transcripts when participant consent allows itmeetings:write: Update your meeting notes and meeting outcome
meetings.list
Your agent host shows this tool as “List meetings”.
List the authenticated student’s non-practice meeting records with measured pagination.
Permissions: This tool needs meetings:read, which the Authorize access page describes as “Read your meetings and meeting details”.
Risk: read. This tool only reads your own data. It never changes anything and it never asks for your approval.
Input
Example call
meetings.list input
Result
A result is never larger than 16,384 bytes. If the stored value does not fit, the tool returns a measured fragment and a cursor for the next one. This tool’s result takes one of these 2 forms, and one call returns exactly one of them. The field named beside each form below says which one you are looking at. Open a form to read its top-level fields.Shape 1
Shape 1
Top-level fields
Shape 2
Shape 2
Top-level fields
Errors
A failed call returns one protocol error with no error code, and its text isTool call failed. every time. This tool looks up no record by id, so it never sends a text that names a record. The error codes page gives every text a read failure can carry.
meetings.get
Your agent host shows this tool as “Get meeting”.
Read one authenticated student meeting record without guest credentials or transcript content.
Permissions: This tool needs meetings:read, which the Authorize access page describes as “Read your meetings and meeting details”.
Risk: read. This tool only reads your own data. It never changes anything and it never asks for your approval.
Input
Example call
meetings.get input
Result
A result is never larger than 16,384 bytes. If the stored value does not fit, the tool returns a measured fragment and a cursor for the next one. This tool’s result takes one of these 2 forms, and one call returns exactly one of them. The field named beside each form below says which one you are looking at. Open a form to read its top-level fields.Shape 1
Shape 1
Top-level fields
Shape 2
Shape 2
Top-level fields
Errors
A failed call returns one protocol error with no error code. Its text isTool call failed. in every case but one: a call that finds no meeting of yours says so and tells the agent to call the matching list tool. The error codes page quotes that text in full and lists the eight kinds of record it can name.
meetings.notes.get
Your agent host shows this tool as “Get meeting notes”.
Read one authenticated student meeting note in measured Unicode-safe fragments.
Permissions: This tool needs meetings:read, which the Authorize access page describes as “Read your meetings and meeting details”.
Risk: read. This tool only reads your own data. It never changes anything and it never asks for your approval.
Input
Example call
meetings.notes.get input
Result
A result is never larger than 16,384 bytes. If the stored value does not fit, the tool returns a measured fragment and a cursor for the next one. A result carries these top-level fields:Top-level fields
Errors
A failed call returns one protocol error with no error code. Its text isTool call failed. in every case but one: a call that finds no meeting of yours says so and tells the agent to call the matching list tool. The error codes page quotes that text in full and lists the eight kinds of record it can name.
meetings.outcome.get
Your agent host shows this tool as “Get meeting outcome”.
Read bounded meeting outcome metadata, with explicit measured views for owner-authored notes or takeaways.
Permissions: This tool needs meetings:read, which the Authorize access page describes as “Read your meetings and meeting details”.
Risk: read. This tool only reads your own data. It never changes anything and it never asks for your approval.
Input
Example call
meetings.outcome.get input
Result
A result is never larger than 16,384 bytes. If the stored value does not fit, the tool returns a measured fragment and a cursor for the next one. This tool’s result takes one of these 2 forms, and one call returns exactly one of them. The field named beside each form below says which one you are looking at. Open a form to read its top-level fields.Shape 1
Shape 1
Top-level fields
Shape 2
Shape 2
Top-level fields
Errors
A failed call returns one protocol error with no error code. Its text isTool call failed. in every case but one: a call that finds no meeting of yours says so and tells the agent to call the matching list tool. The error codes page quotes that text in full and lists the eight kinds of record it can name.
meetings.insights.get
Your agent host shows this tool as “Get meeting insights”.
Read bounded safe meeting insights without transcript-derived quotes, rationale, or narrative evidence.
Permissions: This tool needs meetings:read, which the Authorize access page describes as “Read your meetings and meeting details”.
Risk: read. This tool only reads your own data. It never changes anything and it never asks for your approval.
Input
Example call
meetings.insights.get input
Result
A result is never larger than 16,384 bytes. If the stored value does not fit, the tool returns a measured fragment and a cursor for the next one. This tool’s result takes one of these 2 forms, and one call returns exactly one of them. The field named beside each form below says which one you are looking at. Open a form to read its top-level fields.Shape 1
Shape 1
Top-level fields
Shape 2
Shape 2
Top-level fields
Errors
A failed call returns one protocol error with no error code. Its text isTool call failed. in every case but one: a call that finds no meeting of yours says so and tells the agent to call the matching list tool. The error codes page quotes that text in full and lists the eight kinds of record it can name.
meetings.thank_you.get
Your agent host shows this tool as “Get thank-you draft”.
Read the authenticated student’s thank-you draft without provider identifiers or attachment file ids. The subject and body are templates: double-brace tokens (the contact’s name, the sender’s LinkedIn or scheduling link, an attachment marker) are filled in only at send, and meeting_thank_you_send shows the final text.
Permissions: This tool needs mail:read, which the Authorize access page describes as “Read your outreach templates, thank-you drafts, email delivery jobs, and your outreach settings”, and meetings:read, which the Authorize access page describes as “Read your meetings and meeting details”.
Risk: read. This tool only reads your own data. It never changes anything and it never asks for your approval.
Input
Example call
meetings.thank_you.get input
Result
A result is never larger than 16,384 bytes. If the stored value does not fit, the tool returns a measured fragment and a cursor for the next one. This tool’s result takes one of these 2 forms, and one call returns exactly one of them. The field named beside each form below says which one you are looking at. Open a form to read its top-level fields.Shape 1
Shape 1
Top-level fields
Shape 2
Shape 2
Top-level fields
Errors
A failed call returns one protocol error with no error code. Its text isTool call failed. in every case but one: a call that finds no meeting of yours says so and tells the agent to call the matching list tool. The error codes page quotes that text in full and lists the eight kinds of record it can name.
meetings.transcript.list
Your agent host shows this tool as “Get meeting transcript”.
Read a consented, retained meeting transcript without speaker or provider identifiers.
Permissions: This tool needs meetings:transcript:read, which the Authorize access page describes as “Read meeting transcripts when participant consent allows it”.
Risk: read. This tool only reads your own data. It never changes anything and it never asks for your approval.
Input
Example call
meetings.transcript.list input
Result
A result is never larger than 16,384 bytes. If the stored value does not fit, the tool returns a measured fragment and a cursor for the next one. This tool’s result takes one of these 2 forms, and one call returns exactly one of them. The field named beside each form below says which one you are looking at. Open a form to read its top-level fields.Shape 1
Shape 1
Top-level fields
Shape 2
Shape 2
Top-level fields
Errors
A failed call returns one protocol error with no error code, and this tool sends one of three texts. A call for a meeting your account does not have says so and tells the agent to call the matching list tool. A meeting whose transcript Coffee Chats does not hold answers with a text of its own:A transcript Coffee Chats does not hold
Tool call failed.. The error codes page quotes all three texts.
meetings.notes.update
Your agent host shows this tool as “Update meeting notes”.
What this changes: Replace the private preparation notes on one of the authenticated student’s own meetings, with durable idempotency.
This writes the meeting’s own notes field and not the note the outcome form captures, at most 10000 characters, and the write fails without changing anything if anybody edited those notes first. A practice session is not writable.
Permissions: This tool needs meetings:write, which the Authorize access page describes as “Update your meeting notes and meeting outcome”.
Risk: safe_write. This tool changes one of your own settings as soon as the agent calls it. It does not ask you to approve first, because the change affects only your own account and you can set it back yourself.
Input
Example call
meetings.notes.update input
Result
A result is never larger than 4,096 bytes. This tool’s result takes one of these 4 forms, and one call returns exactly one of them. The field named beside each form below says which one you are looking at. Open a form to read its top-level fields.Shape 1, where tag is completed
Shape 1, where tag is completed
Top-level fields
Shape 2, where tag is accepted
Shape 2, where tag is accepted
Top-level fields
Shape 3, where status is failed
Shape 3, where status is failed
Top-level fields
Shape 4, where status is uncertain
Shape 4, where status is uncertain
Top-level fields
The result may carry a retry hint
A call can be accepted and still ask the agent to come back later. When that happens the result is an accepted result and not a failure, and it carries a hint beside it holding one of these codes and a delay in milliseconds. Nothing has gone wrong and nothing has been written yet.Errors
A call that does not succeed carries one of these codes.meetings.outcome.update
Your agent host shows this tool as “Record meeting outcome”.
What this changes: Record the outcome of one of the authenticated student’s own meetings: the star rating from 0.5 to 5 in steps of 0.5, or null to clear it, the referral outcome, up to 10 key takeaways and the outcome notes, together, with durable idempotency.
It does not mark a thank-you as sent, it does not schedule a follow-up and it does not move the linked contact, all of which the student does in the app. The write fails without changing anything if anybody recorded any part of that outcome first.
Permissions: This tool needs meetings:write, which the Authorize access page describes as “Update your meeting notes and meeting outcome”.
Risk: safe_write. This tool changes one of your own settings as soon as the agent calls it. It does not ask you to approve first, because the change affects only your own account and you can set it back yourself.
Input
Example call
meetings.outcome.update input
Result
A result is never larger than 4,096 bytes. This tool’s result takes one of these 4 forms, and one call returns exactly one of them. The field named beside each form below says which one you are looking at. Open a form to read its top-level fields.Shape 1, where tag is completed
Shape 1, where tag is completed
Top-level fields
Shape 2, where tag is accepted
Shape 2, where tag is accepted
Top-level fields
Shape 3, where status is failed
Shape 3, where status is failed
Top-level fields
Shape 4, where status is uncertain
Shape 4, where status is uncertain
Top-level fields