Skip to main content
GET
/
v1
/
organizations
/
connections
/
{connection_identifier}
/
folders
List Google Drive Folders
curl --request GET \
  --url https://api.mixpeek.com/v1/organizations/connections/{connection_identifier}/folders \
  --header 'Authorization: Bearer <token>'
{
  "description": "List of folders at root",
  "folders": [
    {
      "id": "0AH-Xabc123",
      "mime_type": "application/vnd.google-apps.folder",
      "name": "Marketing",
      "path": "/Marketing"
    },
    {
      "id": "0AH-Xdef456",
      "mime_type": "application/vnd.google-apps.folder",
      "name": "Sales",
      "path": "/Sales"
    }
  ],
  "parent_path": "/"
}

Authorizations

​
Authorization
string
header
required

Bearer token authentication using your API key. Format: 'Bearer your_api_key'. To get an API key, create an account at mixpeek.com/start and generate a key in your account settings.

Headers

​
Authorization
string
required

REQUIRED: Bearer token authentication using your API key. Format: 'Bearer sk_xxxxxxxxxxxxx'. You can create API keys in the Mixpeek dashboard under Organization Settings.

Examples:

"Bearer sk_live_abc123def456"

"Bearer sk_test_xyz789"

Path Parameters

​
connection_identifier
string
required

Connection identifier - either connection ID (conn_...) or name. The system will automatically resolve names to IDs.

Examples:

"conn_abc123def456ghi"

"Marketing Google Drive"

Query Parameters

​
path
string
default:/

Parent folder path to list from

Response

Successful Response

Response payload for listing Google Drive folders.

Returns a list of folders available at the specified path, enabling users to browse and select folders for sync configuration.

​
folders
FolderItem · object[]
required

List of folders found at the specified parent path. Only includes folders (not files). Empty list if no folders found or path doesn't exist.

​
parent_path
string
required

The parent folder path that was queried. This is the path specified in the request (or '/' for root). Use this to show breadcrumb navigation in UI.

Examples:

"/"

"/Marketing"

"/Marketing/2024 Campaigns"