We're upgrading our API
On June 6th, 2019, Mailbox API 1.0 will be sunsetted, and at that time any apps using this legacy API will no longer work. Please use Mailbox API 2.0 instead.
New Conversations Drill-Down
- REST Method: GET
- URLs: https://api.helpscout.net/v1/reports/conversations/new-drilldown.json
This report is similar to the New Conversations Report, but instead of returning statistics about new conversation volume, it drills down and returns the actual new conversations that makes up the New Conversations Report.
A variety of filters are available as query parameters. Including any of these will result in only conversations that match the filters being included in the report.
|start||Date/Time (ISO 8601, in UTC)||Yes||2015-01-01T00:00:00Z|
|end||Date/Time (ISO 8601, in UTC)||Yes||2015-01-31T23:59:59Z|
|mailboxes||list of mailbox identifiers||No||1,2,3|
|tags||list of tag identifiers||No||1,2,3|
|types||list of conversation types (email, chat, or phone)||No||email,chat|
|folders||list of folder identifiers||No||1,2,3|
|page||The page number||No||1|
|rows||Number of results to return per page; defaults to 10; maximum is 50||No||50|
Each response contains one object called conversations.
|Body||conversations.pages||Int||The number of total available pages|
|conversations.page||Int||The current page|
|conversations.count||Int||The number of total conversations included in all pages|
|conversations.results||Collection of Abbreviated Conversations||Contains abbreviated versions of each conversation associated with the search criteria|