Inbox

Mark a conversation read

Resets the conversation’s unread_count to 0 and returns the conversation with its transcript. Nothing changes on LinkedIn or in the mailbox.

POST
/conversations/{id}/read

Authorizations

Authorizationstringheaderrequired

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

Path Parameters

idstringrequired

The conversation's id, from List conversations.

Response

application/json

Success

idstringrequired
scopeenum<string>required

campaigns: a person a campaign reached. other: a LinkedIn or email conversation outside campaigns, from an account whose all_messages is on.

Available options: campaigns, other

personobjectrequired

The other person in the conversation.

campaignobject | nullrequired

The campaign that reached the person; null in scope other.

senderstringrequired

Who answers on your side: the LinkedIn account's name or the email inbox's address, otherwise the workspace name.

reply_channelenum<string>required

Where a reply goes out: linkedin or email, the channel the person last wrote on.

Available options: linkedin, email

intentenum<string> | nullrequired

What the person's latest reply means, as Bavlio read it: interested (open to talking or asking how to proceed), meeting_booked (says a meeting is booked), question (asks something before deciding), referral (points to someone else), not_now (not a priority now, maybe later) or not_interested (a clear no). Null until a reply was read, and always in scope other.

Available options: interested, meeting_booked, question, referral, not_now, not_interested

needs_replybooleanrequired

True while the person's latest reply waits for an answer. Replies read as meeting_booked or not_interested need none; always false in scope other.

unread_countintegerrequired

How many of the person's messages are unread; marking the conversation read resets it.

suggested_replystring | nullrequired

A reply Bavlio drafted to the person's latest message, for you to edit and send; null when there is none, and always in scope other.

meetingobject | nullrequired

The meeting booked with the person; null when none, and always in scope other.

last_message_authorenum<string>required

Who wrote the latest message: lead, campaign or you.

Available options: lead, campaign, you

last_message_previewstringrequired

The first 160 characters of the latest message.

last_message_atstringrequired

When the latest message was sent, ISO 8601.

messagesobject[]required

The whole transcript, oldest message first.