Create a FeedbackSummary resource for a call

POST /2010-04-01/Accounts/{AccountSid}/Calls/FeedbackSummary.json

Call FeedbackSummary resources provide an idea of how your end user's perceive the quality of their calls and the most common issues they have encountered in the context of all your voice traffic during a specific time frame.

Create a FeedbackSummary resource for a call

Path parameters

Body

  • EndDate string(date) Required

    Only include feedback given on or before this date. Format is YYYY-MM-DD and specified in UTC.

  • IncludeSubaccounts boolean

    Whether to also include Feedback resources from all subaccounts. true includes feedback from all subaccounts and false, the default, includes feedback from only the specified account.

  • StartDate string(date) Required

    Only include feedback given on or after this date. Format is YYYY-MM-DD and specified in UTC.

  • StatusCallback string(uri)

    The URL that we will request when the feedback summary is complete.

  • StatusCallbackMethod string(http-method)

    The HTTP method (GET or POST) we use to make the request to the StatusCallback URL.

    Values are HEAD, GET, POST, PATCH, PUT, or DELETE.

Responses

  • 201

    Created

    Hide response attributes Show response attributes object
    • account_sid string | null

      The unique sid that identifies this account

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AC[0-9a-fA-F]{32}$.

    • call_count integer | null

      The total number of calls

    • call_feedback_count integer | null

      The total number of calls with a feedback entry

    • date_created string(date-time-rfc-2822) | null

      The date this resource was created

    • date_updated string(date-time-rfc-2822) | null

      The date this resource was last updated

    • end_date string(date) | null

      The latest feedback entry date in the summary

    • include_subaccounts boolean | null

      Whether the feedback summary includes subaccounts

    • issues array | null

      Issues experienced during the call

    • quality_score_average number | null

      The average QualityScore of the feedback entries

    • quality_score_median number | null

      The median QualityScore of the feedback entries

    • quality_score_standard_deviation number | null

      The standard deviation of the quality scores

    • sid string | null

      A string that uniquely identifies this feedback entry

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^FS[0-9a-fA-F]{32}$.

    • start_date string(date) | null

      The earliest feedback entry date in the summary

    • status string | null

      The status of the feedback summary

      Values are queued, in-progress, completed, or failed.
POST /2010-04-01/Accounts/{AccountSid}/Calls/FeedbackSummary.json 
curl \
 -X POST https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Calls/FeedbackSummary.json \
 --user "username:password" \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -d 'EndDate=2023-05-04&IncludeSubaccounts=true&StartDate=2023-05-04&StatusCallback=https%3A%2F%2Fexample.com&StatusCallbackMethod=HEAD'
Request example 
{
  "EndDate": "2023-05-04",
  "IncludeSubaccounts": true,
  "StartDate": "2023-05-04",
  "StatusCallback": "https://example.com",
  "StatusCallbackMethod": "HEAD"
}
Request examples 
{
  "EndDate": "2025-05-04",
  "IncludeSubaccounts": true,
  "StartDate": "2025-05-04",
  "StatusCallback": "https://example.com",
  "StatusCallbackMethod": "HEAD"
}
Response examples (201) 
{
  "account_sid": "string",
  "call_count": 42,
  "call_feedback_count": 42,
  "date_created": "string",
  "date_updated": "string",
  "end_date": "2023-05-04",
  "include_subaccounts": true,
  "issues": [],
  "quality_score_average": 42.0,
  "quality_score_median": 42.0,
  "quality_score_standard_deviation": 42.0,
  "sid": "string",
  "start_date": "2023-05-04",
  "status": "queued"
}
Response examples (201) 
{
  "account_sid": "string",
  "call_count": 42,
  "call_feedback_count": 42,
  "date_created": "string",
  "date_updated": "string",
  "end_date": "2025-05-04",
  "include_subaccounts": true,
  "issues": [],
  "quality_score_average": 42.0,
  "quality_score_median": 42.0,
  "quality_score_standard_deviation": 42.0,
  "sid": "string",
  "start_date": "2025-05-04",
  "status": "queued"
}