Public/New-GCTelephonyPhone.ps1

<#
.SYNOPSIS
    Creates a new phone in Genesys Cloud.

.DESCRIPTION
    Posts a new phone configuration to the Genesys Cloud API.
    API Endpoint: POST /api/v2/telephony/providers/edges/phones

.PARAMETER Body
    The request body containing the phone configuration including name, site,
    phone base settings, and line base settings.
    Should conform to the Genesys Cloud phone creation schema.

.EXAMPLE
    $phoneBody = @{
        name = 'Lobby Phone'
        site = @{ id = 'site-123' }
        phoneBaseSettings = @{ id = 'phone-base-456' }
        lineBaseSettings = @{ id = 'line-base-789' }
    }
    New-GCTelephonyPhone -Body $phoneBody
    Creates a new phone with the specified configuration.

.NOTES
    Genesys Cloud API: POST /api/v2/telephony/providers/edges/phones
#>

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

    $endpoint = "telephony/providers/edges/phones"
    return Invoke-GCApiRequest -Endpoint $endpoint -Method POST -Body $Body
}