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.
Request
- Base URL: https://api.subscriby.net
- URL: https://api.subscriby.net/v1/connectors
- Auth: HTTP bearer
Query parameters
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.
Response
Array of ConnectorListingResource
Example response
{
"data": [
{
"key": "example",
"name": "Example",
"vendor": "Subscriby",
"version": "1.0.0",
"status": "available",
"status_label": "Available Now",
"installable": true,
"official": true,
"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",
"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",
"portal_cta": {
"label": "Open the app",
"icon": "example"
},
"install_mode": "paste_credential",
"scopes": [
"project"
],
"capabilities": [
"messaging"
],
"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"
],
"missing_commands": [
"manage_connectors"
],
"relay_modes": [
"owner_dm"
],
"recovery": {
"probes": true,
"standby_installations": true,
"resource_standby": true,
"mirror": true,
"identity_relink": true
}
}
]
}Changes
No recorded changes to this operation across all 1 revision of this API.