Skip to navigation
ActivitiesMeetings

Update a Meeting activity

View as Markdown

Most commonly this can be used to update a meetings’s user_note_html or outcome_id.

Authentication

AuthorizationBasic
Use your API key as the username and leave the password empty.
OR
AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

idstringRequired

Request

This endpoint expects any.

Response

Successful response
_typestring

Type of the activity, e.g. Call, Email or Note.

activity_atdatetime or null

When the activity happened, e.g. when an Email or SMS was sent. Defaults to date_created.

actual_durationinteger or null
attached_call_idslist of strings
attendeeslist of objects
calendar_event_uidslist of strings
connected_account_idstring or null
contact_idstring or null

ID of the Contact the activity is with, or null if it isn’t with a particular Contact.

conversation_type_idstring or null
conversation_type_reasonenum or null

How the value was chosen: user-selected by a user, or autodetected by AI.

Allowed values:
created_bystring or null

ID of the user who created the activity, or null if it wasn’t created by a user.

date_createddatetime
When the activity was created.
date_updateddatetime
When the activity was last updated.
durationinteger
ends_atdatetime
idstring

ID of the activity, e.g. acti_abc123.

integrationslist of maps from strings to any
is_recurringboolean
lead_idstring or null

ID of the Lead the activity is on. Can be null for Calls and SMS with phone numbers that don’t match any Contact.

locationstring
notestring
notetaker_idstring or null
organization_idstring
ID of the organization the activity belongs to.
outcome_autofill_confidenceenum or null
How confident AI was in an Outcome it autofilled.
Allowed values:
outcome_autofill_reasoningstring or null
outcome_idstring or null
outcome_reasonenum or null

How the Outcome was set: autofilled by AI, user-selected by a user, or voicemail-dropped automatically after a voicemail drop.

Allowed values:
playbook_idstring or null
playbook_reasonenum or null

How the value was chosen: user-selected by a user, or autodetected by AI.

Allowed values:
provider_calendar_event_idstring or null
provider_calendar_idslist of strings
provider_calendar_typeenum or null
The calendar provider a Meeting was synced from.
Allowed values:
sourceenum

How the Meeting got into Close: calendar if it was synced from a connected calendar, manual if it was created in Close.

Allowed values:
starts_atdatetime
statusenum or null

Status of the Meeting. canceled means it was removed from the synced calendars or has no Lead participants left. declined-by-org means every Close user declined it, declined-by-lead that a Lead participant declined it and none accepted.

summaryobject or null
titlestring
updated_bystring or null

ID of the user who last updated the activity, or null if it wasn’t updated by a user.

user_idstring or null

ID of the user the activity belongs to, e.g. who made the Call or sent the Email. Can be null, e.g. for an incoming SMS to a group number.

user_notestring or null
user_note_date_updateddatetime or null
user_note_htmlstring or null
user_note_mentionslist of strings
userslist of strings
IDs of all users the activity is associated with, e.g. every Close user on an Email Thread or invited to a Meeting.
comment_summaryobject or nullOptional
created_by_agent_idstring or nullOptional
created_by_namestring or nullOptional

Name of the user in created_by.

transcriptslist of nullable objectsOptional
updated_by_namestring or nullOptional

Name of the user in updated_by.

user_namestring or nullOptional

Name of the user in user_id.

agent_config_idstring or nullOptionalDeprecated

Deprecated. Use created_by_agent_id instead.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error