Set a user's emailed call center reports

PUT

/domains/{domain}/users/{user}/emailreports

Last modified:2026-10-14 04:55:46

OperationId:UpdateUserEmailReports

Sets which reports the user receives and how they look. Fields you leave out keep their current value, so you can send only the fields that changed. report-types and frequencies replace the current selection: a report type or frequency missing from the new list stops being sent.

Send an empty report-types (or empty frequencies) to stop every report; the settings are not kept. Read-only fields (time-zone, schedules) are ignored, so a read can be sent back as is.

Changing the send day or time moves the next send to the next matching day and time from now. A report whose schedule did not change keeps its next send time. Returns 202 once the change is accepted; it is applied shortly after.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢202Accepted

application/json

Accepted

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

cURL

Queue and agent reports, daily and weekly at 8:00Stop every report

curl --location --request PUT 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//users//emailreports' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "report-types": [
        "queue",
        "agent"
    ],
    "frequencies": [
        "daily",
        "weekly"
    ],
    "weekly-send-day": 1,
    "send-time": "08:00",
    "cc-email-addresses": [
        "supervisor@example.com"
    ],
    "agent-statistics": [
        "department",
        "calls-answered-count",
        "calls-handling-avg-duration-minutes"
    ]
}'

Response Example

202 - Example 1

{
    "code": 0,
    "message": "string",
    "warnings": [
        "string"
    ]
}

Modified at 2026-10-14 04:55:46

Read a user's emailed call center reports

Stop all of a user's emailed call center reports