Skip to main content

Snyk Admin

Snyk Admin covers the Snyk API calls that need a service account: groups, issues across a whole group, organization members and audit logs.

It is separate from the regular Snyk connector. Snyk's OAuth apps can't call group-level endpoints, and no OAuth scope covers memberships or audit logs, so these tools only work with a service account token. Keeping them here means users who connect Snyk with their own login never see tools that can't work for them.

Enterprise plans only

Snyk's API and service accounts are open to Enterprise plan customers. See Service accounts.

Authentication​

The connector supports API Key (the default) and Client Credentials. Both use a Snyk service account, and the tools can do whatever the service account's role allows. You also pick a Region in Willow.

Use a Group service account. Group-level tokens can call both group and organization endpoints. An organization service account can't list groups or read group issues.

API Key​

Willow sends the token as Authorization: token <token>.

  1. In Snyk, open the Group and go to Settings → Service accounts.
  2. Click Create a service account and enter a unique name, such as willow-admin.
  3. Choose a role. The tools here only read, so start with Group Viewer, which is read-only. Group Admin has full access.
  4. Click Create and copy the token. Snyk shows it once.

Creating a Group service account takes a Group admin.

Client Credentials​

A service account that uses OAuth 2.0 client credentials hands out short-lived access tokens instead of a long-lived token. Willow requests and renews them for you.

  1. Create the Group service account as above, but choose OAuth 2.0 client credentials, or create it with the Snyk API. See Service accounts using OAuth 2.0.
  2. Copy the Client ID and Client Secret. Snyk shows the secret once.

Region​

Pick the region that matches the address you sign in to Snyk at. Tokens only work on their own region's API host.

Sign-in addressRegion in WillowAPI host used
app.snyk.ioSNYK-US-01api.snyk.io
app.us.snyk.ioSNYK-US-02api.us.snyk.io
app.eu.snyk.ioSNYK-EU-01api.eu.snyk.io
app.au.snyk.ioSNYK-AU-01api.au.snyk.io

Configure in Willow​

  1. In Willow, go to MCP Servers → + Add MCP server.
  2. Find the Snyk Admin card and click + Use.
  3. Under Configuration, pick your Region.
  4. Under Authentication, choose API Key and paste the token, or Client Credentials and paste the client ID and secret.
  5. Click Save Changes.
  6. To check it, run List Groups. A list with your group confirms the token and region match.

Available Tools​

The Snyk Admin connector provides 6 tools. All of them are read-only.

  • List Groups — groups the token can access. This is a beta endpoint in Snyk's API.
  • List Group Organizations — organizations in a group. Use it to find the organization ID the other tools take.
  • List Organization Members — members of an organization with their role, filterable by email or role.
  • List Group Issues — issues across every organization in a group, filterable by type, severity, status, ignored state and dates.
  • Get Group Issue — one group issue in full: CVE and CWE identifiers, severities, exploit maturity, fix options, risk score.
  • Search Organization Audit Logs — user activity in an organization, newest first, from a date range.

Pagination​

List tools return a next_cursor when more results exist. Pass it back as starting_after (or cursor for audit logs) to get the next page.

Troubleshooting​

401 Unauthorized on every call​

Cause: The token is wrong, revoked or expired, or it belongs to a different region than the one selected.

Solution: Check the Region against your sign-in address. If the region is right, create a new token.

403 Forbidden on group tools​

Cause: The service account belongs to an organization, not the group, or its group role doesn't allow the call.

Solution: Create the service account on the Group with the Group Viewer or Group Admin role.

Additional Resources​