Yay.com loading

Loading

Error Sorry

0

Shopping Basket

Basket Total

$0.00

incVAT

Delete everything from your basket?

Go to Checkout

Mailbox Menus

Mailbox Menus allow Mailboxes to be accessed using an extension number

Become a Reseller

Filter:

  • All
  • GET
  • POST
  • PUT
  • DELETE
  • Chargeable *

* You will be charged every time this command is run.

  • GET/voip/mailbox-menu

    Gets all active Mailbox Menus on an account

    Back to top

    Request Details

    Response Details

    Request Details

    This command has no URL/Query String parameters

    Response Details

    200 Response

    {
        "result" : [
            {
                "created_on" : "2019-09-17",
                "extension" : 8001,
                "mailbox" : "6431abcd-f7de-4bda-ae6e-29516f344e45",
                "name" : "Pete's Mailbox Menu",
                "updated_on" : "2019-09-17",
                "uuid" : "31347d42-00bd-44a5-9b5c-20dc4197a2f6"
            }
        ],
        "status_code" : 200,
        "status_message" : "OK"
    }
  • GET/voip/mailbox-menu/{uuid}

    Gets a specific Mailbox Menu on an account

    Back to top

    Request Details

    Response Details

    Request Details

    URL and Query String Parameters

    • Name

    • Type

    • Required

      • uuid

      • String

      • True

      The UUID of the Mailbox Menu to be queried

    Response Details

    200 Response

    {
        "result" : {
            "created_on" : "2019-09-17",
            "extension" : 8001,
            "mailbox" : "6431abcd-f7de-4bda-ae6e-29516f344e45",
            "name" : "Pete's Mailbox Menu",
            "updated_on" : "2019-09-17",
            "uuid" : "31347d42-00bd-44a5-9b5c-20dc4197a2f6"
        },
        "status_code" : 200,
        "status_message" : "OK"
    }

    404 Response

    {
        "result" : {},
        "status_code" : 404,
        "status_message" : "Not Found"
    }
  • POST/voip/mailbox-menu

    Creates a new Mailbox Menu

    Back to top

    Request Details

    Response Details

    Request Details

    This command has no URL/Query String parameters

    POST body

    • Name

    • Type

    • Required

      • extension

      • int

      • True

      The extension number assigned to this Mailbox Menu

      • mailbox

      • String

      • True

      The UUID of the Mailbox this Menu provides access to, or 'personal' if linked to a User's personal Mailbox

      • name

      • String

      • True

      The name of this Mailbox Menu

    JSON all-fields example:

    {
        "extension" : 8001,
        "mailbox" : "6431abcd-f7de-4bda-ae6e-29516f344e45",
        "name" : "Pete's Mailbox Menu"
    }

    Response Details

    201 Response

    {
        "result" : {
            "created_on" : "2019-09-17",
            "extension" : 8001,
            "mailbox" : "6431abcd-f7de-4bda-ae6e-29516f344e45",
            "name" : "Pete's Mailbox Menu",
            "uuid" : "31347d42-00bd-44a5-9b5c-20dc4197a2f6"
        },
        "status_code" : 201,
        "status_message" : "Created"
    }

    400 Response

    {
        "result" : {},
        "status_code" : 400,
        "status_message" : "Bad Request"
    }

    409 Response

    {
        "result" : {},
        "status_code" : 409,
        "status_message" : "Conflict"
    }
  • PUT/voip/mailbox-menu/{uuid}

    Updates the specified Mailbox Menu

    Back to top

    Request Details

    Response Details

    Request Details

    URL and Query String Parameters

    • Name

    • Type

    • Required

      • uuid

      • String

      • True

      The UUID of the Mailbox Menu to be updated

    PUT body

    • Name

    • Type

    • Required

      • extension

      • int

      • True

      The extension number assigned to this Mailbox Menu

      • mailbox

      • String

      • True

      The UUID of the Mailbox this Menu provides access to, or 'personal' if linked to a User's personal Mailbox

      • name

      • String

      • True

      The name of this Mailbox Menu

    JSON all-fields example:

    {
        "extension" : 8001,
        "mailbox" : "6431abcd-f7de-4bda-ae6e-29516f344e45",
        "name" : "Pete's Mailbox Menu"
    }

    Response Details

    200 Response

    {
        "result" : {
            "created_on" : "2019-09-17",
            "extension" : 8001,
            "mailbox" : "6431abcd-f7de-4bda-ae6e-29516f344e45",
            "name" : "Pete's Mailbox Menu",
            "updated_on" : "2019-09-17",
            "uuid" : "31347d42-00bd-44a5-9b5c-20dc4197a2f6"
        },
        "status_code" : 200,
        "status_message" : "OK"
    }

    400 Response

    {
        "result" : {},
        "status_code" : 400,
        "status_message" : "Bad Request"
    }

    404 Response

    {
        "result" : {},
        "status_code" : 404,
        "status_message" : "Not Found"
    }

    409 Response

    {
        "result" : {},
        "status_code" : 409,
        "status_message" : "Conflict"
    }
  • DELETE/voip/mailbox-menu/{uuid}

    Deletes the specified Mailbox Menu

    Back to top

    Request Details

    Response Details

    Request Details

    URL and Query String Parameters

    • Name

    • Type

    • Required

      • uuid

      • String

      • True

      The UUID of the Mailbox Menu to be deleted

    Response Details

    204 Response

    {
        "result" : {},
        "status_code" : 204,
        "status_message" : "No Content"
    }

    404 Response

    {
        "result" : {},
        "status_code" : 404,
        "status_message" : "Not Found"
    }
  • GET/voip/next-extension/mailbox-menu

    Gets the next valid Mailbox menu extension

    Back to top

    Request Details

    Response Details

    Request Details

    This command has no URL/Query String parameters

    Response Details

    400 Response

    {
        "result" : {},
        "status_code" : 400,
        "status_message" : "Bad Request"
    }

    404 Response

    {
        "result" : {},
        "status_code" : 404,
        "status_message" : "Not Found"
    }
ISO 27001 Business Continuity Accreditation ISO 22301 Business Continuity Accreditation Cyber Essentials Certificate of Assurance G-Cloud accredited by the Crown Commercial Service