---
title: "Get a specific integration type"
method: GET
path: "/integration/type/{name}/"
tags: ["integration-types"]
---

# Get a specific integration type

`GET /integration/type/{name}/`

## Request

- Base URL: `https://api.getoneprofile.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getoneprofile.ai/integration/type/{name}/`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Get detailed information about a specific integration type by its name. Returns the integration type's categories, display name, description, and configuration schemas.

## Path parameters

- `name` string, required

## Response `200`

Successful Response

- IntegrationTypeRead: Integration type metadata for the directory listing.
  - `categories` string[], required: e.g. ['CRM', 'Marketing Automation']
  - `company_domain` string, required: e.g. 'google.com', 'intercom.com'
  - `config_schema` object, nullable, required: OpenAPI schema for connection settings. None if not implemented.
  - `connect_methods` IntegrationConnectMethod[]: The ways a user can connect this integration. Contains 'oauth_connect' when an app-listing OAuth manifest exists, and 'credentials_form' when the SDK exposes a non-empty (API-key) credentials form. A single-method type returns exactly one entry (the UI renders as before); a type supporting both returns both (the UI shows a chooser). Empty for unimplemented types.
  - `created_at` string, date-time, required: When added to directory
  - `credentials_schema` object, nullable, required: OpenAPI schema for auth credentials. None if not implemented.
  - `description` string, required: What the integration does, shown in detail view
  - `display_name` string, required: UI label. e.g. 'Google Sheets'
  - `icon_url` string, required: Full URL to icon. e.g. 'https://static.../intercom.svg'
  - `id` string, uuid, required: Unique ID. e.g. '123e4567-e89b-12d3-a456-426614174000'
  - `implemented` boolean, required: False = coming soon, can't connect yet
  - `integration_type` string, required: Unique ID. e.g. 'googlesheets', 'intercom'
  - `is_marketplace_listing` boolean: True when this integration has a marketplace app-listing (OAuth-connect or credentials-form). Orthogonal to connect_method: the directory renders a 'Connect <X>' button for a marketplace listing even when connect_method is 'credentials_form'. Derived from the app-listings catalog.
  - `kind` 'source' | 'destination' | 'both': Query filter: source-only, destination-only, or both.
  - `name` string, required: Sort key. e.g. 'Google Sheets', 'Intercom'
  - `overview` string, required: Brief overview of the integration's sync capabilities
  - `record_types` IntegrationRecordTypeReadSchema[]: Record types this integration syncs, as display-ready chips. Empty for 'coming soon' integrations. Wildcard integrations include a 'Custom' marker.
    - `display_name` string, required: Human-readable name (e.g. 'Person', 'Contacts', 'Custom').
    - `is_custom` boolean, required: True for the wildcard 'Custom' marker (arbitrary/dynamic record types).
    - `slug` string, required: The record-type slug (e.g. 'person', 'contacts'), or '*' for Custom.
  - `tagline` string, required: Short tagline naming key data objects synced
  - `updated_at` string, date-time, required: Last metadata update

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Integration type not found
- `422`: Invalid request made to the API.
- `500`: Internal server error.
- `502`: Bad gateway error.
- `503`: Service unavailable.

---

[API](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile.md) · [All operations](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/llms.txt) · [OpenAPI document](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/revisions/4a6bd71e3f02?raw)