---
title: "Get Connection Config"
method: GET
path: "/connections/config/{connectionType}"
tags: ["Connections"]
---

# Get Connection Config

`GET /connections/config/{connectionType}`

## Request

- Base URL: `https://partner.peaka.studio/api/v1`
- URL: `https://partner.peaka.studio/api/v1/connections/config/{connectionType}`
- Auth: HTTP bearer

Returns the configuration schema for a specific connection type, including required credential fields and their types. Use this to understand what parameters are needed when creating a connection of this type.

## Path parameters

- `connectionType` string, required

## Response `200`

Connection configuration

- ConnectionConfiguration
  - `connectionType` string: The type of the connection. e.g. stripe, airtable, etc.
  - `connectionTypeLabel` string: The label for the connection type.
  - `name` string: The name of the connection.
  - `authorizationType` string: The type of authorization used for the connection. e.g. oauth2, api_key, bearer_token, etc.
  - `credentialSchemaType` string: The type of the credential schema used for the connection.
  - `redirectRequired` boolean: Flag to indicate if the connection requires redirection to a 3rd party platform. e.g. OAuth2 connections often require redirection to the 3rd party platform for authorization. If this flag is set to true, the connection will be redirected to the 3rd party platform for authorization. According to your use case, some extra steps may be required to complete the authorization process. See: https://docs.peaka.com/how-to-guides/how-to-create-oauth2-based-connections-via-peaka
  - `category` string: The category of the connection.
  - `configuration` ConnectionConfigurationItem[]: The list of configuration fields for the connection.
    - `fieldName` string: The name of the field.
    - `fieldType` 'text' | 'number' | 'boolean' | 'object': The type of the field. `object` is a map of string keys to string values, e.g. Oracle's `advancedParameters`: {"metadata.cache-ttl": "10m"}.
    - `required` boolean: Indicates whether the field is required.
    - `description` string: The description of the field.
  - `documentationUrl` string: The URL for the documentation of the connection.
  - `keywords` string[]: Search aliases and abbreviations for the connection type, e.g. ["pg", "psql", "postgre"] for POSTGRES. Useful for matching a user's or an LLM's free-text name for a data source to a connection type.

---

[API](https://skmtc.dev/peaka/apis/peaka-gateway-api.md) · [All operations](https://skmtc.dev/peaka/apis/peaka-gateway-api/llms.txt) · [OpenAPI document](https://skmtc.dev/peaka/apis/peaka-gateway-api/revisions/e68b033a22d5?raw)