> ## Documentation Index
> Fetch the complete documentation index at: https://hub-docs.wundergraph.com/llms.txt
> Use this file to discover all available pages before exploring further.

# WunderGraph Cosmo

Connect your graph to WunderGraph Cosmo to synchronize schema definitions and manage federated graphs.

## Setup and Configuration

### Step 1: Access Integration Settings

1. Navigate to your graph in the dashboard
2. Go to the **Settings** section
3. Click on **Integrations**
4. Select **Schema Registry** integration

### Step 2: Choose Your Platform

Select **WunderGraph Cosmo** from the dropdown.

## WunderGraph Cosmo Integration

### Prerequisites

* Active WunderGraph Cosmo account
* API key with appropriate permissions
* Access to your Cosmo studio

### Step 3: Generate Cosmo API Token

To learn how to generate an API key, click [here](https://cosmo-docs.wundergraph.com/studio/api-keys).

### Step 4: Configure Cosmo Integration

1. **Select Platform**: Choose "WunderGraph Cosmo" from the dropdown
2. **Enter API Token**: Paste your Cosmo API token
3. **Choose Integration Mode**: Select either "Select Graph" or "Create Graph"

#### Option A: Select Existing Graph

If you want to connect to an existing Cosmo graph:

1. **Select Graph Tab**: Click on "Select Graph"
2. **Choose Graph**: Select from available graphs organized by namespace
   * Graphs are grouped by their namespace (e.g., `default`, `production`)
3. **Save Configuration**: Click "Save" to complete the integration

#### Option B: Create New Graph

If you want to create a new federated graph in Cosmo:

1. **Create Graph Tab**: Click on "Create Graph"
2. **Graph Name**: Enter a unique name for your new graph
3. **Namespace**: Select the target namespace from available options
4. **Routing URL**: Enter the URL where the router will be accessible
   * Example: `https://api.example.com/graphql`
5. **Label Matchers** (Optional): Add label matchers for subgraph selection
   * Format: `key=value` pairs
   * Press Enter or Space to add each matcher
   * Example: `env=production`, `team=backend`
6. **Save Configuration**: Click "Save" to create and connect the graph