Description

n8n-nodes-subscriby

Verified community node for n8n that drives Subscriby — subscription + access-code monetisation for Telegram communities.

Provides two nodes:

• Subscriby Trigger — starts a workflow when a Subscriby event fires. Covers subscriptions, payments, members, access codes, coupons, Smart Links, plans, projects, project resources, payment methods, connector installations and outages, billing, groups, roles, teams, team members, member support conversations, saved replies and inbox settings, what a project teaches Subscriby Copilot (Knowledge), message broadcasts, and the Disaster Recovery ledger (191 events total). Uses the /v1/webhook-subscriptions lifecycle and validates the SB-Signature HMAC on every request.
• Subscriby — action node for every documented route on api.subscriby.net. Covers 36 resources across creator-facing surfaces (projects, plans, pass windows, subscriptions, subscribers, members, broadcasts, support conversations, canned replies, support inbox settings, Knowledge, Copilot Credit, coupons, Smart Links, Revenue Recovery and its win-back sequences, the Referral Program, the Partner Program, creator tasks, the notification centre, the Disaster Recovery ledger, the Connector Directory and a project’s installations, access codes, resources, payment methods), admin surfaces (teams, team members, roles, groups, tokens, webhook endpoints, webhook deliveries, activity log), and read-only data surfaces (analytics, distribution links).

Installation

Community install (recommended)

Inside n8n:

1. Settings → Community Nodes → Install
2. Enter n8n-nodes-subscriby
3. Confirm and restart n8n

Manual install (self-hosted)

cd ~/.n8n/custom
npm install n8n-nodes-subscriby

Restart the n8n process after install.

Setup

1. Mint an API token at https://app.subscriby.net/settings/tokens. Every token is auto-bound to a team (scope:team:); you pick the abilities it carries. See the ability catalogue for the full list. Minimums per use-case:
– Trigger node — webhook-endpoint:manage. Restrict to a single project by also scoping the token to that project (scope:project:).
– Read-only workflows — combine :view / :view-any abilities for the resources you list or fetch (e.g. project:view-any, project-subscription:view, project-subscription-plan:view, project-access-code:view-any, team-member:view-any, role:view, group:view, project-recovery:view-any, activity:read, dashboard:read, distribution:read, billing:read).
– Write workflows — add the matching :create / :update / *:delete abilities (e.g. project:create, project-subscription-plan:update, project-access-code:create, project-resource:delete). Cancelling a subscription is project-subscription:update; banning/kicking a member is project-user:update.
2. In n8n, Credentials → New → Subscriby API and paste the sbt_... token. Leave the base URL at the default unless you are self-hosting.
3. Add a Subscriby Trigger node, pick one or more events, optionally scope to a single project, and activate the workflow. On activation n8n registers the endpoint with Subscriby. Deactivating the workflow deletes the endpoint.

Supported events (191)

The full catalogue is defined in nodes/SubscribyTrigger/events.ts and mirrors the event reference. This table is generated from that file by npm run sync:readme — do not edit it by hand.

| Family | Count | Events |
| —— | —– | —— |
| Access Code | 3 | accesscode.expired, accesscode.generated, access_code.redeemed |
| Billing | 10 | billing.accountlocked, billing.graceperiodwarning, billing.invoicecreated, billing.invoiceoverdue, billing.invoicepaid, billing.paymentfailed, billing.tiercancelled, billing.tierdowngraded, billing.tierupgraded, billing.trial_ending |
| Broadcast | 2 | broadcast.completed, broadcast.queued |
| Checkout | 2 | checkout.recovered, checkout.stalled |
| Connector | 10 | connector.connected, connector.disconnected, connector.doctorcompleted, connector.installed, connector.settingsupdated, connector.outageclosed, connector.outagecompensated, connector.outageopened, connector.statuschanged, connector.uninstalled |
| Copilot Credit | 4 | copilotcredit.granted, copilotcredit.low, copilotcredit.purchased, copilotcredit.refunded |
| Coupon | 7 | coupon.activated, coupon.created, coupon.deactivated, coupon.deleted, coupon.exhausted, coupon.redeemed, coupon.updated |
| Creator Task | 2 | creatortask.completed, creatortask.opened |
| Group | 4 | group.created, group.deleted, group.members_synced, group.updated |
| Knowledge | 3 | knowledge.created, knowledge.deleted, knowledge.updated |
| Member | 16 | member.banned, member.churned, member.converted, member.identitylinked, member.identityunlinked, member.joined, member.kicked, member.leadcreated, member.removed, member.resourceadded, member.resourcepending, member.accessextended, member.resourcereissued, member.resourceremoved, member.trial_joined, member.unbanned |
| Partner | 10 | partner.applicationapproved, partner.applicationrejected, partner.payoutrecorded, partner.ratechanged, partner.referralconverted, partner.referralsignedup, partner.rewardapproved, partner.rewardcredited, partner.rewardearned, partner.reward_reversed |
| Pass | 8 | pass.holdermissed, pass.holdermoved, pass.holderqueued, pass.holderstranded, pass.windowcancelled, pass.windowclosed, pass.windowopened, pass.windowscheduled |
| Pass Series | 8 | passseries.completed, passseries.legadded, passseries.legcompleted, passseries.legdropped, passseries.legsubstituted, passseries.presaleopened, passseries.purchased, passseries.seatsexhausted |
| Payment | 4 | payment.failed, payment.pending, payment.refunded, payment.succeeded |
| Plan | 8 | plan.activated, plan.created, plan.deactivated, plan.deleted, plan.orderchanged, plan.soldout, plan.sync_completed, plan.updated |
| Project | 6 | project.archived, project.created, project.deleted, project.design_published, project.restored, project.updated |
| Project Payment Method | 2 | project.paymentmethod.deleted, project.paymentmethod.updated |
| Project Resource | 6 | project.resource.created, project.resource.deleted, project.resource.linked, project.resource.status_changed, project.resource.unlinked, project.resource.updated |
| Recovery | 13 | recovery.identityrelinked, recovery.incidentopened, recovery.incidentresolved, recovery.operationcompleted, recovery.operationfailed, recovery.operationreverted, recovery.operationstarted, recovery.readinesschanged, recovery.installationfailedover, recovery.resourcefailedover, recovery.resourcereplaced, recovery.standbyregistered, recovery.standby_removed |
| Referral | 10 | referral.affiliateapproved, referral.affiliatejoined, referral.affiliatesuspended, referral.captured, referral.converted, referral.payoutrecorded, referral.programupdated, referral.rewardapproved, referral.rewardearned, referral.rewardreversed |
| Role | 3 | role.created, role.deleted, role.updated |
| Sequence | 7 | sequence.converted, sequence.created, sequence.deleted, sequence.enrolled, sequence.exited, sequence.step_sent, sequence.updated |
| Smart Link | 3 | link.archived, link.created, link.updated |
| Subscription | 21 | subscription.accessrestored, subscription.accesssuspended, subscription.activated, subscription.cancellationfeedback, subscription.cancelled, subscription.created, subscription.downgraded, subscription.expired, subscription.offertaken, subscription.pastdue, subscription.paused, subscription.paymentrecovered, subscription.reactivated, subscription.refunded, subscription.renewed, subscription.trialconverting, subscription.trialexpired, subscription.trial_started, subscription.unpaid, subscription.unpaused, subscription.upgraded |
| Support | 12 | support.cannedreply.created, support.cannedreply.deleted, support.canned_reply.updated, support.conversation.assigned, support.conversation.blocked, support.conversation.opened, support.conversation.reopened, support.conversation.resolved, support.conversation.unblocked, support.message.received, support.message.sent, support.settings.updated |
| Team | 3 | team.created, team.deleted, team.updated |
| Team Member | 4 | team.member.invited, team.member.joined, team.member.removed, team.member.role_changed |
| Total | 191 | |

Supported actions

| Resource | Operations |
| ——————– | —————————————————————————————————————- |
| Access Code | Bulk Generate, List, Delete, Preview |
| Account | Get Me |
| Activity | List |
| Analytics | Get Dashboard, Get Earnings, Get Subscribers, Get Connector Analytics, Get Revenue Composition, Get Transaction Breakdown, Get Plan Performance, List Transactions |
| Broadcast | Send, Preview, List Audiences |
| Canned Reply | List, Get, Create, Update, Delete |
| Connector | List, Get, List Installations, Get Installation, Install, Verify, Restore Access, Run Doctor, Update Settings, Disconnect, Get Uninstall Preview, Uninstall |
| Copilot Credit | Get Balance, List Statement, Update Settings |
| Coupon | Create, Update, Activate, Deactivate, Delete, List, Get |
| Creator Task | List, Complete |
| Distribution | Get Portal URL, Get Deep Link |
| Group | Create, Update, Sync Members, Delete, List, Get |
| Knowledge | List, Create, Get, Update, Delete |
| Member | Ban, Unban, Kick, Get, List |
| Notification | List, Mark Read, Mark All Read |
| Partner Program | Get, List Referrals, Get Referral, List Rewards, List Payouts, Update Payout Details, Accept Terms |
| Pass Window | List, Get, Create, Cancel, Remind Queue |
| Payment Method | List, Get, Activate, Deactivate, Sync Plans, Delete |
| Plan | Create, Update, Publish, Unpublish, Start Next Season, Arrange Storefront Order, Get, List, Delete, Find by Name |
| Portal Design | Get, Update, Publish, Discard Draft |
| Project | Create, Update, Archive, Restore, Delete, List, Get, Find by Handle |
| Recovery | Get Readiness, List Incidents, Get Incident, List Operations, Get Operation, Get Roll Call, Get Allowances |
| Referral Program | Get Program, Update Program, Activate Program, Deactivate Program, Delete Program, List Affiliates, Get Affiliate, Add Affiliate, Approve Affiliate, Suspend Affiliate, List Referrals, Get Referral, List Rewards, List Payouts, Record Payout |
| Resource | Create, Update, Activate, Deactivate, List, Get, Unlink, Delete |
| Revenue Recovery | Get Settings, Update Settings, Get Stats, List Cancellations, List Activity, List Checkouts |
| Role | Create, Update, Delete, List, Get |
| Sequence | List, Create, Get, Update, Delete, List Enrollments |
| Smart Link | Create, Update, Archive, List, Get, Funnel |
| Subscriber | Find by Connector Account |
| Subscription | Cancel, Get, List, List Grants, Reissue Grants, Pause Access, Unpause Access, Reactivate, Remind Pass Holder, Remind to Connect |
| Support Conversation | List, Get, List Messages, Reply, Resolve, Reopen, Assign, Block Contact, Unblock Contact |
| Support Settings | Get, Update |
| Team | Create, Update, Delete, List, Get, Get Current |
| Team Member | Invite, Change Role, Remove, Cancel Invitation, List, Get |
| Token | List, Get, Revoke |
| Webhook Delivery | List, Get, Retry, Retry Dead |
| Webhook Endpoint | List, Get, Create, Pause, Resume, Delete, Rotate Secret, Test |

Every mutation automatically sends a fresh Idempotency-Key header so node re-runs never double-fire.

Development

npm install
npm run build    # compile TS + copy icons
npm run dev      # watch mode
npm run lint

To test against a local n8n:

npm link
cd ~/.n8n/custom
npm link n8n-nodes-subscriby
n8n start

Links

• Subscriby documentation
• n8n integration guide
• API reference
• Event reference

License

MIT