# Snyk

Baton Snyk Connector - Sync groups, organizations, and users from Snyk

## Prerequisites

- A Mesh administrator account with permission to manage connectors.
- `group_id` (optional) — Snyk Group ID (optional - use for enterprise accounts with groups)
- `org_ids` (optional) — Comma-separated list of Snyk Organization IDs to sync (optional)
- `hostname` (optional) — Snyk API hostname (defaults to api.snyk.io)
- Credentials for authentication: api_token (stored write-only).

## Authentication

**Method:** Bearer token

Mesh authenticates with a token (personal access token, API token, or bot token).

| Field | Required | Secret | Description |
| --- | --- | --- | --- |
| `api_token` | Yes | Yes (write-only) | Snyk API Token (stored as secret) |

## Capabilities

<CapabilityMatrix
  capabilities={[
    { name: "Identity & entitlement sync", supported: true },
    { name: "Writeback / remediation", supported: false, notes: "Read-only" },
  ]}
/>

## Data model

_This information is not yet available from the connector schema._

## Setup

1. Gather the required value: `group_id`.
2. Gather the required value: `org_ids`.
3. Gather the required value: `hostname`.
4. Create the required credentials in the source system: api_token.
5. In Admin → Connectors, add the connector and enter its configuration.
6. Save and run an initial collection.

## Troubleshooting

_This information is not yet available from the connector schema._