---
title: "ListSCMOrganizations"
method: POST
path: "/gitpod.v1.RunnerService/ListSCMOrganizations"
tags: ["gitpod.v1.RunnerService"]
---

# ListSCMOrganizations

`POST /gitpod.v1.RunnerService/ListSCMOrganizations`

Lists SCM organizations the user belongs to.

 Use this method to:
 - Get all organizations for a user on a specific SCM host
 - Check organization admin permissions for webhook creation

 ### Examples

 - List GitHub organizations:

   Lists all organizations the user belongs to on GitHub.

   ```yaml
   runnerId: "d2c94c27-3b76-4a42-b88c-95a85e392c68"
   scmHost: "github.com"
   ```

## Query parameters

- `pageSize` integer
- `token` string

## Request body

- GitpodV1ListSCMOrganizationsRequest
  - `runnerId` string, uuid
  - `scmHost` string — The SCM host to list organizations from (e.g., "github.com", "gitlab.com")

## Response `200`

Success

- GitpodV1ListSCMOrganizationsResponse
  - `organizations` GitpodV1ListSCMOrganizationsResponseSCMOrganization[] — List of organizations the user belongs to
    - `isAdmin` boolean — Whether the user has admin permissions in this organization. Admin permissions typically allow creating organization-level webhooks.
    - `name` string — Organization name/slug (e.g., "gitpod-io")
    - `url` string — Organization URL (e.g., "https://github.com/gitpod-io")

## Other responses

- `default` — Error

## Changes

- **2026-01-21** `2423c089f280` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/gitpod-io/apis/gitpod-v1/changes/gitpod.v1.RunnerService/ListSCMOrganizations/post.md)

---

[API](https://skmtc.dev/gitpod-io/apis/gitpod-v1.md) · [All operations](https://skmtc.dev/gitpod-io/apis/gitpod-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gitpod-io/gitpod-v1/revisions/b97dcde84128/schema)