---
title: "Average handle time"
method: POST
path: "/inbox/v1/reporting/metrics/handle-time"
tags: ["Inbox"]
---

# Average handle time

`POST /inbox/v1/reporting/metrics/handle-time`

## Request

- Base URL: `https://platform.hootsuite.com`
- URL: `https://platform.hootsuite.com/inbox/v1/reporting/metrics/handle-time`
- Auth: OAuth 2
  - Authorization code: `https://platform.hootsuite.com/oauth2/auth`
  - Token URL: `https://platform.hootsuite.com/oauth2/token`

The average time in seconds that a conversation is handled by an agent, specifically the difference between timestamps
of conversation open and conversation pend/resolve. For Average Handle Time to be calculated, there must be an outbound
between open and pend/resolve event.

## Request body

- HandleTimeRequest
  - `from` string, required: An `ISO-8601` date time marking the inclusive start of the result. Must be URL encoded. The `from` filter can be a maximum of 14 days in the past.
  - `to` string: An `ISO-8601` date time marking the exclusive end of the result. Must be URL encoded
  - `mediumIds` MediumId[]
  - `channelIds` ChannelId[]
  - `userIds` UserId[]
  - `handleTimeTypes` string[]

## Response `200`

Success

- NumberMetricResponse
  - `value` integer

## Other responses

- `401`: Unauthorized: when using an invalid or expired access token.

---

[API](https://skmtc.dev/hootsuite/apis/hootsuite-rest-api.md) - [All operations](https://skmtc.dev/hootsuite/apis/hootsuite-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hootsuite/apis/hootsuite-rest-api/revisions/adac53bd28bb?raw)