---
title: "List connectors"
method: GET
path: "/partner/app/{appId}/bizai/agent_connectors"
tags: ["Configure — Connectors"]
---

# List connectors

`GET /partner/app/{appId}/bizai/agent_connectors`

## Request

- Base URL: `https://partner.gupshup.io`
- URL: `https://partner.gupshup.io/partner/app/{appId}/bizai/agent_connectors`
- Auth: API key in header `Authorization`

## Response `200`

Connectors.

- Connector[]
  - `id` string: Meta resource id.
  - `name` string
  - `description` string
  - `base_url` string
  - `connector_protocol` 'HTTP' | 'MCP'
  - `auth_type` 'OAUTH2_CLIENT_CREDENTIALS' | 'API_KEY' | 'NONE'
  - `auth_config` object
  - `user_auth_injection_config` UserAuthInjectionConfig: Where the consumer's own auth token is injected on outbound calls.
    - `location` 'body' | 'headers' | 'path' | 'query', required
    - `field_name` string, required
    - `prefix` string, required
  - `connection_status` object
    - `status` 'PENDING_OAUTH' | 'ACTIVE' | 'EXPIRED' | 'ERROR'
    - `error_message` string
  - `mcp_tool_sync` object, nullable: Null for HTTP connectors.
    - `status` 'ERROR' | 'PENDING' | 'READY'
    - `last_attempted_at` integer
    - `last_successful_at` integer
    - `fingerprint` string
    - `tool_count` integer
  - `mtls_config` object
    - `has_certificate` boolean
    - `fingerprint` string
    - `expires_at` integer
    - `subject` string
    - `client_certificate` string
    - `ca_certificate` string

## Other responses

- `400`: The agent has not been onboarded, or the connector request is invalid.
- `401`: Missing, invalid, or foreign-app token. Raised by Partner Portal before any forwarding.
- `429`: Per-app rate limit exceeded. Retry after the 60-second window.

---

[API](https://skmtc.dev/gupshup/apis/partner-portal-meta-business-agent-bizai-api.md) - [All operations](https://skmtc.dev/gupshup/apis/partner-portal-meta-business-agent-bizai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gupshup/apis/partner-portal-meta-business-agent-bizai-api/revisions/4c52185f2153?raw)