Connectors
Install the platforms your project runs on, connect and verify them, read their health, and uninstall one without losing your members' history.
A project runs on connectors: the platforms it gates access on, sends messages through and takes payments from. The Connectors page of a project lists what it runs and lets you install more from the directory.
Installed connectors
Open a project and choose Connectors in the sidebar. Every installation the project holds is a row:
- Connector — which platform, and whether the installation is live (the one that acts for the project) or a standby kept by the Disaster Recovery Program.
- State —
Pending(installed, not connected yet),Connected,Degraded(the last probe found something wrong; hover for the reason),Revoked(the platform withdrew it) orDisconnected(you did). A Sales Paused badge beside a degraded state means the platform refused the installation outright (token revoked or regenerated, bot deleted): every plan that unlocks a place on that connector is off sale until it answers again, and members are compensated when it does — see Connector outages. A red Paused badge means Subscriby has switched the whole connector off during an incident on our side or the platform's: nothing is sent through it, nothing is probed, and what members send waits on the platform until it is switched back on. Your installations, plans and members are untouched. - Account — the platform's own name and handle for the installation (the bot's name and username).
- Last checked — when the hourly health probe, or a verify you ran, last asked the platform.
The row's menu offers:
- Connect — on a pending installation, also offered as a button beside the row's menu, opens the connector's own dialog: paste the credential it asks for and activate it, or, for a connector added by signing in such as Discord, press Connect and finish on the platform's own page. Once the installation is connected the same entry reads Reconnect, and it is where you replace a credential or move the project onto a different bot: paste the new token, and the new bot takes over the moment the platform accepts it.
- Verify — a fresh probe rather than the hourly one; the state updates at once.
- Restore Access — offered after you install a connector again that you had uninstalled, once it is connected. Every place the uninstall detached is asked about; the ones the connector still controls come back active, and every member with a live purchase of a plan granting them gets fresh access to exactly those places (nothing they already hold is touched). A place the connector no longer controls stays detached — run the doctor to see why — and plans the uninstall took off sale stay off sale until you publish them again.
- Disconnect — the connector withdraws the installation and its credentials are wiped. Members keep their access; grants, resources, plans and identities are untouched. Connect again at any time.
- Uninstall — removes the connector from the project after showing you what that touches (below).
The directory
Browse Marketplace opens the in-app Connectors Marketplace with this project already picked: every connector Subscriby knows, lane by lane — Available Now, Experimental, Paused, Under Development, Coming Soon — with its badges (Official or Community, New, Trending) and a one-line description. Connect to a project on an available card opens a pending installation on this project and brings you back to this page, where connecting it with its credentials finishes the job.
A second connector on one project needs Growth
Official connectors are free. Running two different connectors on the same project (and selling plans that span them) is a Growth feature: the second install is refused until the project owner upgrades, or the other connector is uninstalled.
Uninstalling a connector
Uninstalling is not disconnecting, and it never deletes anything. Before anything happens, the dialog shows the impact:
- how many of the connector's resources will be detached (deactivated, their platform ids kept),
- how many members lose access (every live grant on those resources is revoked and the member is put outside),
- which plans are left with nothing to grant, and how many recurring and one-time purchases sit on them.
When plans would be emptied, two switches appear, both on by default:
- Take the emptied plans off sale — the plans are unpublished so nobody buys a plan that grants nothing.
- Cancel their recurring subscriptions at period end and email each member — every live recurring subscription on those plans stops renewing; members keep their access until the end of the paid period and receive an email saying so. One-time and lifetime purchases are never cancelled; a refund stays your call.
The installation stays on record as uninstalled with its settings kept, and member accounts are never removed. Installing the connector again brings it back as pending; the detached resources stay inactive until you relink them.
From the API and MCP
Everything on this page is on the Connectors API and the MCP tools (list_connectors, install_connector, verify_connector_installation, disconnect_connector, get_connector_uninstall_preview, uninstall_connector), and the connector.* webhook events announce every move. Connecting, which needs the credential typed by a person, stays on the dashboard.
How is this guide?
Last updated on