Forward voicemail message

Copies a voicemail message into the new folder of another mailbox, and emails that user the new-voicemail notice. Your copy stays where it is. The recipient's copy shows who forwarded it in voicemail-forward-from: the user, or user@domain when the message came from another domain.

Name the recipient in voicemail-forward-new-destination: a bare user (extension) such as 1002 means that user in the path's domain, and user@domain, such as 1002@acme.example.com, names a mailbox in that domain. The mailbox the message is in cannot be the recipient.

Any user may forward a message from its own mailbox to any mailbox in its own domain. Otherwise your scope must be able to change both mailboxes: Site Manager within its site, Office Manager and Route Manager within their own domain, Reseller and Route Manager Reseller within their territory, and Super User anywhere. So a recipient in another domain needs Reseller (a domain in its territory) or Super User. Anything else returns 403. Office Manager Read-Only and Super User Read Only never forward.

The copy and its metadata are written on the server that handles the request and copied to the other servers over the service bus (SBUS) file journal. The call answers 202. Each forward is recorded in the compliance access log as a disclosure of the message to the recipient. Only PATCH and PUT are accepted.

A missing or malformed recipient, or the message's own mailbox, returns 400. A recipient that does not exist returns 404, one without voicemail returns 409, and one without room for the message returns 507. A message that is not in the folder returns 404.

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Responses

🟠404

application/json

Recipient not found: no such user in the recipient's domain (the path's domain for a bare extension). Voicemail not found: the message is not in the folder. The domain in the path may also not exist. Check the recipient and the filename.

Bodyapplication/json

🟠400

🟠401

🟢202Accepted

🟠403Forbidden

🟠409Conflict

🔴507Insufficient Storage

🟠405Method Not Allowed

🔴500Internal Server Error

curl --location --request PATCH 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//users//voicemails/new/vm-20260901143000123456-0e4a6c8b2d1f3a5c7e9b0d2f4a6c8e1b.wav/forward' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "voicemail-forward-new-destination": "1002" }'

Request

Responses