Create custom connector

• Authorization

  string

  header

  required

  Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

• title

  string

  required
• url

  string

  required

  https URL Productlane calls. http works only for localhost.

• logo_url

  string | null

  https URL of the logo shown next to the connector, such as the logo of the system it wraps. Defaults to the favicon of url; null clears it.

• type

  enum<string>

  http: Productlane POSTs the contact to your URL and renders the returned sidebar components and actions. mcp: an MCP server whose tools the agent can call.

  One of:

  http

  mcp
  Default:

  http
• description

  string | null

  Tells the agent when to use this connector.

• order

  integer

  Sidebar position, lowest first. Defaults to the end.

• headers

  object[]

  Replaces the full header list. A saved header left out is deleted.

  Default:

  []
  Show fields
• available_to_agent

  boolean

  http only: let the customer-facing agent read this connector and run its actions. For mcp, set agent_tools instead.

• agent_tools

  string[]

  mcp only: tools the customer-facing agent may call. Tool names come from GET /settings/custom-connectors/{id}/tools. Every other tool stays internal (copilot, AI drafts).

• internal_blocked_tools

  string[]

  mcp only: tools hidden from internal callers as well.

• reachable_without_identity

  boolean

  mcp only: the widget agent may call it before the visitor verifies their email. Only for public knowledge like docs or status.

Successful response

• id

  string

  required
• title

  string

  required
• description

  string | null

  required
• url

  string

  required
• logo_url

  string | null

  required

  Logo shown in the sidebar. null shows the favicon of url.

• type

  enum<string>

  required
  One of:

  http

  mcp
• order

  integer

  required
• headers

  object[]

  required

  Header names only. Stored values are encrypted and never returned.

  Show fields
• available_to_agent

  boolean

  required

  Whether the customer-facing agent (widget, email, Slack replies) may read this connector. For mcp connectors it is true when agent_tools is not empty.

• agent_tools

  string[]

  required

  mcp only: tools the customer-facing agent may call. Every other tool stays internal (copilot, AI drafts).

• internal_blocked_tools

  string[]

  required

  mcp only: tools hidden from internal callers as well.

• reachable_without_identity

  boolean

  required

  mcp only: the widget agent may call it before the visitor verifies their email. For public knowledge like docs or status.

• tool_policies

  any

  Field rules per tool name, in the dashboard's policy format. Set with PUT /settings/custom-connectors/{id}/tool-policy.

• created_at

  string

  required
• updated_at

  string

  required