Skip to content

list_queue_email_addresses async

list_queue_email_addresses(
    instance_id: InstanceId,
    queue_id: QueueId,
    *,
    config_overrides: Optional[AsyncConnectClientConfig] = None,
    next_token: Optional[NextToken] = None,
    max_results: Optional[MaxResult100] = None,
) -> ListQueueEmailAddressesResponse

Lists all email addresses that are currently associated with a specific queue, providing details about which "From" email addresses agents can select when handling email contacts. This helps administrators manage agent email address options and understand the available choices for different brands and business units.

Important things to know

  • The response includes metadata about each email address available for agent selection, including whether it's configured as the default outbound email.

  • Agents can select from these email addresses when replying to inbound contacts or initiating outbound contacts in this queue.

  • The list includes both explicitly associated email addresses and any default outbound email address configured for the queue.

  • Results are paginated to handle queues with many associated email addresses (up to 50 per queue).

Parameters:

  • instance_id (InstanceId) –

    The identifier of the Connect Customer instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

  • queue_id (QueueId) –

    The identifier for the queue.

  • next_token (Optional[NextToken], default: None ) –

    The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.

  • max_results (Optional[MaxResult100], default: None ) –

    The maximum number of results to return per page.

Raises:

Source code in docs_src/capo_connect/_services/async_connect.py
async def list_queue_email_addresses(
    self,
    instance_id: "capo_connect.types.instance_id.InstanceId",
    queue_id: "capo_connect.types.queue_id.QueueId",
    *,
    config_overrides: Optional[AsyncConnectClientConfig] = None,
    next_token: Optional["capo_connect.types.next_token.NextToken"] = None,
    max_results: Optional["capo_connect.types.max_result100.MaxResult100"] = None,
) -> "capo_connect.types.list_queue_email_addresses_response.ListQueueEmailAddressesResponse":
    """<p>Lists all email addresses that are currently associated with a specific queue, providing details about which "From" email addresses agents can select when handling email contacts. This helps administrators manage agent email address options and understand the available choices for different brands and business units.</p> <p> <b>Important things to know</b> </p> <ul> <li> <p>The response includes metadata about each email address available for agent selection, including whether it's configured as the default outbound email.</p> </li> <li> <p>Agents can select from these email addresses when replying to inbound contacts or initiating outbound contacts in this queue.</p> </li> <li> <p>The list includes both explicitly associated email addresses and any default outbound email address configured for the queue.</p> </li> <li> <p>Results are paginated to handle queues with many associated email addresses (up to 50 per queue).</p> </li> </ul>

    Args:
        instance_id: <p>The identifier of the Connect Customer instance. You can <a href="https://docs.aws.amazon.com/connect/latest/adminguide/find-instance-arn.html">find the instance ID</a> in the Amazon Resource Name (ARN) of the instance.</p>
        queue_id: <p>The identifier for the queue.</p>
        next_token: <p>The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.</p>
        max_results: <p>The maximum number of results to return per page.</p>

    Raises:
        capo_connect.errors.access_denied_exception.AccessDeniedException: <p>You do not have sufficient permissions to perform this action.</p>
        capo_connect.errors.internal_service_exception.InternalServiceException: <p>Request processing failed because of an error or failure with the service.</p>
        capo_connect.errors.invalid_parameter_exception.InvalidParameterException: <p>One or more of the specified parameters are not valid.</p>
        capo_connect.errors.invalid_request_exception.InvalidRequestException: <p>The request is not valid.</p>
        capo_connect.errors.resource_not_found_exception.ResourceNotFoundException: <p>The specified resource was not found.</p>
        capo_connect.errors.throttling_exception.ThrottlingException: <p>The throttling limit has been exceeded.</p>
        capo_connect.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    async def _handler(
        req: "AsyncOperationRequest[capo_connect.types.list_queue_email_addresses_request.ListQueueEmailAddressesRequest]",
    ) -> AsyncOperationResponse[
        "capo_connect.types.list_queue_email_addresses_response.ListQueueEmailAddressesResponse"
    ]:
        import capo_connect._operations.amazon_connect_service.list_queue_email_addresses

        (
            output,
            http_response,
        ) = await capo_connect._operations.amazon_connect_service.list_queue_email_addresses.async_list_queue_email_addresses(
            req.options, req.input
        )
        return AsyncOperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("ListQueueEmailAddresses")
    )
    input_: capo_connect.types.list_queue_email_addresses_request.ListQueueEmailAddressesRequest = {
        "instance_id": instance_id,
        "queue_id": queue_id,
    }
    if next_token is not None:
        input_["next_token"] = next_token
    if max_results is not None:
        input_["max_results"] = max_results

    response = await aexecute_pipeline(
        AsyncOperationRequest(input=input_, options=options_),
        handler=_handler,
        interceptors=list(interceptors_),
    )
    await response.response.aclose()
    return response.output