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

# Average first response time

`POST /inbox/v1/reporting/metrics/first-response-time`

## Request

- Base URL: `https://platform.hootsuite.com`
- URL: `https://platform.hootsuite.com/inbox/v1/reporting/metrics/first-response-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 to the first response to an inbound message.

## Request body

- ResponseTimeRequest
  - `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
  - `timezone` string: The `timezone` to be used in conjunction with`groupByInterval`, e.g. America/Los_Angeles. Must be URL encoded. If no `timezone` is provided, the default 'UTC' timezone is used
  - `mediumIds` MediumId[]
  - `channelIds` ChannelId[]
  - `teamIds` TeamId1[]
  - `groupByInterval` 'MINUTE' | 'HOUR' | 'DAY' | 'MONTH' | 'YEAR' | 'HOUR_BY_DAY': An interval to group results by. No more than 60 intervals can be requested per request. For example, when selecting `minute`, the requested time range cannot be longer than 1 hour
  - `groupBy` 'TEAM'

## Response `200`

Success

- union
  - NumberMetricResponse
    - `value` integer
  - GroupedMetricResponse
    - `value` object
  - TimeSeriesMetricResponse
    - `value` object[]

## 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)