## 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

- `token: optional string`

- `pageSize: optional number`

### Body Parameters

- `runnerId: optional string`

- `scmHost: optional string`

  The SCM host to list organizations from (e.g., "github.com", "gitlab.com")

### Returns

- `organizations: optional array of object { isAdmin, name, url }`

  List of organizations the user belongs to

  - `isAdmin: optional boolean`

    Whether the user has admin permissions in this organization.
    Admin permissions typically allow creating organization-level webhooks.

  - `name: optional string`

    Organization name/slug (e.g., "gitpod-io")

  - `url: optional string`

    Organization URL (e.g., "https://github.com/gitpod-io")

### Example

```http
curl https://app.gitpod.io/api/gitpod.v1.RunnerService/ListSCMOrganizations \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $GITPOD_API_KEY" \
    -d '{}'
```

#### Response

```json
{
  "organizations": [
    {
      "isAdmin": true,
      "name": "name",
      "url": "url"
    }
  ]
}
```