List the connector directory

Every connector Subscriby knows, lane by lane, installable connectors first, each with its badges and, for a registered one, its whole manifest and the connect form. ?status= narrows to one lane.

curl https://api.subscriby.net/v1/connectors \  -H "Authorization: Bearer $SUBSCRIBY_TOKEN"

Cards come lane by lane, installable connectors first; within a lane the most installed connector comes first (installations, the number of projects running it today, uninstalled rows excluded) and the name breaks ties. The public and in-app directories offer the same order plus Newest (added_at) and Name, and filter on official, installable and category; a client sorts and filters on the same fields.

Lanes and badges

`status`	`status_label`	Meaning
`available`	Available Now	A package is present and configuration offers it; `installable` is `true`.
`beta`	Experimental	Available, and flagged so; a badge on the card, never a gate. `installable` is `true`.
`paused`	Paused	Switched off during an incident. Nothing new is installed and sends queue until it is back.
`in_development`	Under Development	A package exists but configuration does not offer it yet (built, on staging, dark).
`coming_soon`	Coming Soon	A roadmap entry with no package behind it: the card, the category and an `eta` sentence only.

badges are facts the platform stamps, never a package's own claim: official or community (who publishes it), new while the listing was added within the last sixty days, trending for the connector(s) creators installed most in the last thirty days. A coming_soon card carries none.

Requires ability

project-connector:view-any

The token must hold this ability, or the call is refused with 403.

MCP tool

list_connectors

Runs the same action from an agent, behind the same ability.

Authorization

bearerToken

AuthorizationBearer <token>

A personal access token minted on the dashboard under Settings, then Tokens, sent as Authorization: Bearer sbt_live_…. The token carries the abilities each endpoint lists under Requires ability and is frozen to one team.

In: header

Query Parameters

status?string

Narrow the directory to one lane: available, beta, paused, in_development or coming_soon. Omit for every lane. An unknown lane is 422 VALIDATION_FAILED naming the accepted values.

Responses

200OKapplication/json

Array of ConnectorListingResource

data*array<>

The items.

401UnauthorizedAUTHENTICATION_REQUIREDapplication/json

The request carries no bearer token, or one that is revoked, malformed, or minted for another environment (an sbt_test_ token on production).

error*

The one envelope every failure uses.

403ForbiddenTOKEN_MISSING_ABILITYapplication/json

The token is valid but does not carry the ability this endpoint requires; error.context.required_ability names the one to grant. An endpoint that also checks who owns a row or which tier the account is on answers FORBIDDEN, TEAM_TIER_REQUIRED or CONNECTOR_TIER_REQUIRED with the same status, and says so in its own description.

error*

The one envelope every failure uses.

422Validation failedVALIDATION_FAILEDapplication/json

When status names no lane; error.context.accepted lists the lanes.

error*

The one envelope every failure uses.

429Too many requestsRATE_LIMITEDapplication/json

The token has spent its 300 requests a minute or 10,000 an hour; Retry-After says when the next one is accepted.

error*

The one envelope every failure uses.

Call it from your code

A sample request in your language, the body each status answers with, and the types to hold them.

curl -X GET "https://example.com/v1/connectors?status=available"

{  "data": [    {      "key": "example",      "name": "Example",      "vendor": "Subscriby",      "version": "1.0.0",      "status": "available",      "status_label": "Available Now",      "installable": true,      "official": true,      "badges": [        {          "key": "official",          "label": "Official"        },        {          "key": "trending",          "label": "Trending"        }      ],      "installations": 1284,      "category": "messaging",      "tagline": "Sell access to channels and groups through your own bot.",      "overview": "Connect a bot you created on the platform and Subscriby runs your membership there: …",      "icon": "example",      "eta": null,      "links": {        "documentation": "https://docs.subscriby.net/connectors/example",        "support": "mailto:support@subscriby.net",        "privacy": "https://example.org/privacy",        "terms": "https://example.org/tos",        "homepage": "https://example.org"      },      "added_at": "2025-04-21",      "changelog_url": "https://www.subscriby.net/blog",      "sign_in_required": false,      "portal_cta": {        "label": "Open the app",        "icon": "example"      },      "install_mode": "paste_credential",      "scopes": [        "project",        "platform"      ],      "resource_kinds": [        {          "kind": "channel",          "label": "Channel",          "portal_label": "Channel",          "icon": "megaphone",          "grant_mode": "bearer_link",          "supports_early_admission_hold": true,          "upgrades_from": null,          "plan_kinds": [            "one_time",            "recurring",            "pass",            "pass_series"          ]        },        {          "kind": "group",          "label": "Group",          "portal_label": "Group",          "icon": "user-group",          "grant_mode": "bearer_link",          "supports_early_admission_hold": true,          "upgrades_from": null,          "plan_kinds": [            "one_time",            "recurring",            "pass",            "pass_series"          ]        }      ],      "capabilities": [        "messaging",        "broadcasts",        "management_surface",        "access_control",        "early_admission_hold",        "support_relay",        "recovery_probes",        "recovery_standby_installations",        "recovery_resource_standby",        "recovery_mirror",        "recovery_identity_relink",        "creator_registration",        "portal_login",        "native_payments"      ],      "messaging": {        "max_length": 4096,        "buttons_per_row": 8,        "max_buttons": 100,        "callback_data_bytes": 64,        "supports_underline": true,        "supports_spoiler": true,        "supports_files": true      },      "pacing": {        "min_interval_microseconds": 35000,        "burst": 30,        "per_recipient_interval_microseconds": 1000000      },      "management_commands": [        "project_create",        "project_settings",        "project_delete",        "installation_connect",        "resource_link",        "resource_manage",        "plan_create",        "plan_manage",        "payment_method_setup",        "coupon_create",        "access_codes_generate",        "broadcast",        "support_reply",        "support_relay_setup",        "recovery_relink",        "recovery_standby",        "recovery_replace_resource",        "account_recovery_email"      ],      "missing_commands": [        "manage_connectors",        "creator_tasks",        "recovery_status",        "set_alert_destination"      ],      "relay_modes": [        "owner_dm",        "forum_group"      ],      "recovery": {        "probes": true,        "standby_installations": true,        "resource_standby": true,        "mirror": true,        "identity_relink": true      },      "install_fields": [        {          "name": "instructions",          "type": "instructions",          "label": "Create a bot on the platform, then paste its token here.",          "help": "You can customise the bot afterwards …",          "required": false,          "rules": [],          "options": [],          "value": null,          "steps": [            "Open the platform's app and create a bot.",            "Copy the token it gives you and paste it in the input below.",            "Click on \":button\" to connect your bot to :app."          ],          "links": []        },        {          "name": "token",          "type": "secret",          "label": "Bot token",          "help": "Keep it secret: anyone who has it controls the bot.",          "required": true,          "rules": [            "string",            "regex:/^[0-9]{6,12}:[A-Za-z0-9_-]{30,64}$/"          ],          "options": [],          "value": null,          "steps": [],          "links": []        }      ],      "settings_fields": []    },    {      "key": "roadmap-example",      "name": "Roadmap Example",      "vendor": "Subscriby",      "version": null,      "status": "coming_soon",      "status_label": "Coming Soon",      "installable": false,      "official": false,      "badges": [],      "installations": 0,      "category": "messaging",      "tagline": "Gate channels and workspaces behind your plans, no manual invites.",      "overview": null,      "icon": "roadmap-example",      "eta": "Planned",      "links": null,      "added_at": null,      "changelog_url": null,      "sign_in_required": true,      "portal_cta": null,      "install_mode": null,      "scopes": [],      "resource_kinds": [],      "capabilities": [],      "messaging": null,      "pacing": null,      "management_commands": [],      "missing_commands": [],      "relay_modes": [],      "recovery": null,      "install_fields": [],      "settings_fields": []    }  ]}

Type definitions

The shapes above as types, ready to paste into your client.

export interface Response {  data: ConnectorListingResource[];}export interface ConnectorListingResource {  key: string;  name: string;  vendor: string | null;  version: string | null;  status: string;  status_label: "Available Now" | "Experimental" | "Paused" | "Under Development" | "Coming Soon";  installable: boolean;  official: boolean;  badges: unknown[];  installations: number;  category: string;  tagline: string;  overview: string | null;  icon: string;  eta: string | null;  links: Links | null;  added_at: string | null;  changelog_url: string | null;  sign_in_required: boolean;  portal_cta: PortalCta | null;  install_mode: string | null;  scopes: unknown[];  resource_kinds: unknown[];  capabilities: unknown[];  messaging: Messaging | null;  pacing: Pacing | null;  management_commands: unknown[];  missing_commands: unknown[];  relay_modes: string[];  recovery: Recovery | null;  install_fields: unknown[];  settings_fields: unknown[];}export interface Links {  documentation: string | null;  support: string | null;  privacy: string | null;  terms: string | null;  homepage: string | null;}export interface PortalCta {  label: string;  icon: string;}export interface Messaging {  max_length: number;  buttons_per_row: number;  max_buttons: number;  callback_data_bytes: number;  supports_underline: boolean;  supports_spoiler: boolean;  supports_files: boolean;}export interface Pacing {  min_interval_microseconds: number;  burst: number;  per_recipient_interval_microseconds: number;}export interface Recovery {  probes: boolean;  standby_installations: boolean;  resource_standby: boolean;  mirror: boolean;  identity_relink: boolean;}

List the connector directory

Lanes and badges

AuthorizationCopy Anchor Link

Query ParametersCopy Anchor Link

ResponsesCopy Anchor Link

Authorization

Query Parameters

Responses