---
title: "Register a self-hosted connector manifest"
method: POST
path: "/connections/connectors"
tags: ["Setup · Connections"]
---

# Register a self-hosted connector manifest

`POST /connections/connectors`

## Request

- Base URL: `https://api.ziggsai.com`
- URL: `https://api.ziggsai.com/connections/connectors`
- Auth: HTTP bearer

## Request body

- CreateConnectorManifestDto
  - `provider` string, required
  - `label` string, required
  - `status` 'draft' | 'active' | 'disabled'
  - `authMode` 'api_key' | 'oauth2', required
  - `apiKey` ConnectorManifestApiKeyDto
    - `header` string, required
    - `prefix` string
  - `oauth` CreateConnectorManifestOAuthDto
    - `authorizeUrl` string, required
    - `tokenUrl` string, required
    - `scopes` string[], required
    - `clientId` string, required: OAuth client id; stored as vault ref, never returned
    - `clientSecret` string, required: OAuth client secret; stored as vault ref, never returned
    - `usePkce` boolean: Default true; set false for providers without PKCE
    - `scopeDelimiter` 'space' | 'comma'
    - `tokenResponseFields` ConnectorManifestOAuthTokenFieldsDto
      - `accessToken` string
      - `refreshToken` string
      - `expiresIn` string
      - `scope` string
    - `authorizeExtraParams` object: Extra authorize query params (e.g. audience)
  - `baseUrl` string, required
  - `actions` ConnectorManifestActionDto[], required
    - `name` string, required
    - `method` string, required
    - `urlTemplate` string, required
    - `headerTemplates` object
    - `bodyTemplate` string
    - `resourceTemplate` string, required
  - `trustTier` 'self' | 'third_party': self = own API (default); third_party requires domain verification
  - `visibility` 'owner' | 'org' | 'published'

## Response `201`

Created

- ConnectorManifestResponseSchema
  - `manifest` object, required

---

[API](https://skmtc.dev/ziggsai/apis/ziggs-developer-api.md) · [All operations](https://skmtc.dev/ziggsai/apis/ziggs-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ziggsai/apis/ziggs-developer-api/revisions/eda79030e072?raw)