Public/New-GCConversationsEmail.ps1

<#
.SYNOPSIS
    Creates a new email conversation.

.DESCRIPTION
    Initiates a new email conversation in Genesys Cloud.
    Calls POST /api/v2/conversations/emails.

.PARAMETER Body
    The request body containing email details such as to address, queue, subject, and direction.

.EXAMPLE
    $emailBody = @{
        toAddress = 'customer@example.com'
        queueId = 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'
        subject = 'Follow-up'
        direction = 'OUTBOUND'
    }
    New-GCConversationsEmail -Body $emailBody

.NOTES
    Genesys Cloud API: POST /api/v2/conversations/emails
#>

function New-GCConversationsEmail {
    [CmdletBinding()]
    param(
        [Parameter(Mandatory = $true)]
        [object]$Body
    )

    $endpoint = "conversations/emails"
    return Invoke-GCApiRequest -Endpoint $endpoint -Method POST -Body $Body
}