The meeting object
Returned by every route under /v1/meetings. A call carries the same fields except bot_history — see the call object for what differs.
idstringAlways prefixed mtg_. A call_ id does not address a meeting: the API refuses it rather than resolving it in the other collection.
objectmeetingResource type. A record captured from a VoIP integration is a call; everything else is a meeting. Independent of type, which describes the media: a call can be video and a meeting can be audio.
titlestringSanitized meeting title.
statuscompletedOnly semantically completed meetings are public in V1.
typevideo · audioMeeting media type.
audienceinternal · externalMeeting audience classification.
meeting_atstring date-timeMeeting instant in UTC.
duration_secondsintegerNon-negative meeting duration.
no_showbooleanWhether the completed meeting had no attendee.
participantsarray of objectNormalized external participants.
ownerobjectThe user the record belongs to. Company scoping follows this user’s default company.
Public meeting template reference when available.
tagsarray of objectPublic tag references.
customer_questionsarray of objectCustomer questions detected in the call.
competitorsarray of objectCompetitors mentioned in the call.
Enablement summary when available.
accountsarray of objectCompany-scoped accounts linked to the meeting.
overall_evaluationobjectOverall evaluation readiness and score summary.
skill_scoresarray of objectPer-skill scores; empty when no skill evaluation exists.
transcriptobjectTranscript availability and its consistent processing state.
created_atstring date-timeUTC instant when the meeting entered Salesbud.
updated_atstring date-timeUTC instant of the last change to the meeting record itself. Informational only: it does not advance when a dependent resource such as a transcript, tag or answer changes without touching the meeting row, so it is not a reliable incremental-sync marker.
bot_historyarray of objectRecording bot events. Present only on a meeting: a VoIP capture has no bot, so a call does not carry this field at all.
Nested objects
Section titled “Nested objects”Meeting participant
Section titled “Meeting participant”display_namestringoptionalSanitized external participant name when available.
emailstring emailoptionalNormalized lowercase email when available.
phonestringoptionalNormalized phone number when available.
kindexternalParticipant classification in V1.
Meeting owner
Section titled “Meeting owner”idstringOpaque owner identifier.
namestringPublic owner display name.
emailstring emailnullableNormalized owner email, or null when legacy data is malformed.
Owner default team inside the authenticated company.
Meeting owner team
Section titled “Meeting owner team”idstringOpaque team identifier.
namestringTeam display name.
roleparticipant · leadership · observerRole of the owner in the team. participant sees only their own meetings; leadership sees the team’s and is visible to it; observer sees the team’s without appearing to the other members.
is_defaultbooleanWhether this is the owner’s default team in the company. False when the owner has no default team there and the API reported another one instead, which is why the field exists rather than being implied.
Template reference
Section titled “Template reference”idstringOpaque public template identifier.
namestringPublic display name.
answersarray of objectSanitized template questions and meeting answers.
Meeting template answer
Section titled “Meeting template answer”fieldstringOpaque public template question field identifier.
questionstringQuestion text as it was asked, sanitized.
answerstringAnswer generated for this question. A question that produced none is left out of the list rather than returned with a null answer.
Tag reference
Section titled “Tag reference”idstringOpaque public tag identifier.
namestringPublic display name.
Meeting customer question
Section titled “Meeting customer question”questionstringQuestion the customer asked during the conversation.
categorystringCategory the question was classified into.
Meeting competitor
Section titled “Meeting competitor”idstringOpaque competitor identifier.
namestringCompetitor name as registered by the company, not as spoken.
Meeting enablement
Section titled “Meeting enablement”next_stepsstringnullableNext steps agreed in the conversation, or null when none were identified.
meeting_typequalification · negotiation · proposal · closing · technical_meeting · questions_clarificationsnullableSales stage the conversation was classified as, or null. Often null on calls: the classifier was built for sales meetings.
speaking_durationobjectHow long each side spoke.
speaking_duration.usersarray of objectOne entry per company user who spoke. A user who did not speak is left out rather than reported with zero.
speaking_duration.users[].userobjectA company user as the API exposes them anywhere other than owner: the same identifier, without the team.
speaking_duration.users[].duration_secondsintegerHow long this user spoke, in seconds.
speaking_duration.others_secondsintegernullableHow long everyone outside the company spoke, in seconds, or null when the split was not measured. Not broken down per person: the other side is not identified by user.
Public user reference
Section titled “Public user reference”A company user as the API exposes them anywhere other than owner: the same identifier, without the team.
idstringOpaque user identifier, the same one owner.id carries.
namestringPublic user display name.
emailstring emailnullableNormalized lowercase user email, or null when legacy data is malformed.
Account reference
Section titled “Account reference”idstringOpaque account identifier.
domainstringAccount email domain, lowercased.
cnpjstringnullableBrazilian company registration number as stored, with or without punctuation, or null when unknown.
Meeting skill score
Section titled “Meeting skill score”userobjectThe user the score refers to.
skillobjectThe skill that was scored.
skill.idstringOpaque skill identifier.
skill.namestringSkill name as the company registered it.
scoreintegerScore from 0 to 10.
justificationstringnullableWhy the score was given, or null when the evaluation produced none.
Meeting bot event
Section titled “Meeting bot event”codestringnullableWhat happened to the recording bot, as a stable code.
subcodestringnullableFurther detail on the event, or null when the code carries none.
occurred_atstring date-timeWhen the event happened.