Legacy Mailbox API 1.0 is deprecated

Support for legacy Mailbox API 1.0 was ended on June 6, 2019. Please use Mailbox API 2.0 going forward. If you have any questions or need help with the new API, please reach out.

Get Folders

  • REST Method: GET
  • URLs: https://api.helpscout.net/v1/mailboxes/{id}/folders.json

Request

Name Type Required Default Notes
page Int No 1  

To request subsequent pages:
https://api.helpscout.net/v1/mailboxes/{id}/folders.json?page=2

Response

Response Name Type Notes
Header Status Int 200 if successful
Body page Int Current page that was passed in on the request
pages Int Total number of pages available
count Int Total number of objects available
items Collection Collection of Folder objects
Status: 200 OK
{
    "page": 1,
    "pages": 1,
    "count": 4,
    "items": [{
        "id": 1234,
        "name": "Mine",
        "type": "mine",
        "userId": 4532,
        "totalCount": 2,
        "activeCount": 1,
        "modifiedAt": "2012-07-24T20:18:33Z"
        },
        {... folder object ...},
        {... folder object ...},
        {... folder object ...}
    ]
}