Integration with Collab.Land (Token-Gated Access)
You launched an NFT collection on Ethereum, but after a week you noticed users without tokens entering your Discord server. Manual moderation doesn't scale, and CAPTCHA bots don't solve the problem—you need on-chain asset ownership verification. We, a team of blockchain engineers with 5+ years of experience, help you set up Collab.Land so that only holders of your tokens or NFTs get access.
Collab.Land is a bot for Discord and Telegram that checks token ownership and automatically assigns roles. Integration takes from a few hours to a couple of days, but requires understanding of the token verification system and supported condition types. Below, we break down how it works and how to solve common problems.
How token-gating with Collab.Land solves access control
The scheme is simple: a user joins Discord, clicks "Verify," signs a message via their wallet (free, no transaction), Collab.Land checks the on-chain balance, and assigns a role. Supported asset types:
- ERC-20: minimum token balance
- ERC-721: ownership of an NFT from a collection, specific tokenId, or trait-based
- ERC-1155: ownership of a specific token ID
- Multi-chain: Ethereum, Polygon, Base, Arbitrum, Optimism, BSC, and others
This approach eliminates human error and guarantees that only real holders get access. For standard scenarios, you can configure rules in the Command Center.
Why choose Collab.Land over building your own bot?
Developing a custom token-gating bot requires infrastructure: nodes, databases, signature handling, and Discord API integration. Collab.Land cuts launch time by 3-5x. We have completed 10+ Collab.Land integrations and confirm that even complex scenarios with custom API are faster to implement than building from scratch. And if you need non-standard logic, Collab.Land offers Miniapp and API.
What our integration service includes
We offer turnkey integration. As a result, you get:
- Configured token gates for Discord and/or Telegram
- Custom rules for staked tokens, LP positions, or multi-wallet
- Administration documentation
- Testing and gas optimization (if using receipt tokens)
- One month of post-launch support
Our team holds Solidity and Ethereum certifications and has experience in 50+ blockchain projects. We guarantee correct operation and verification security.
How we set up integration: stages
- Analysis: identify asset types and roles to be auto-assigned.
- Design: choose the approach—standard rules via Command Center, custom API, or Miniapp.
- Implementation: configure rules, write custom logic code if needed.
- Testing: verify with test accounts that verification works correctly.
- Deploy: move to production, train administrators.
Timeline: from 1 day for a standard scenario to 5 days for a complex one with Miniapp. We'll assess your project within 1 business day—contact us.
Supporting staked and locked tokens
A common problem: a user stakes tokens, their ERC-20 balance becomes 0, and they lose their role. Two solutions exist.
Option 1 — Staking receipt token: upon staking, a receipt ERC-20 (stTOKEN) is issued. Collab.Land checks the receipt token balance—the user keeps the role while staking is active.
Option 2 — Custom Miniapp: Collab.Land Miniapp lets you write a TypeScript function that checks any on-chain state—balance in a staking contract, Uniswap V3 NFT positions, etc. Example:
// Collab.Land Miniapp — custom check import { TokenBalanceRule } from "@collabland/discord"; export async function checkBalance( address: string, chainId: number ): Promise<bigint> { // Sum of native + staked balance const stakingContract = getContract(STAKING_ADDRESS, chainId); const [walletBalance, stakedBalance] = await Promise.all([ token.balanceOf(address), stakingContract.stakedBalanceOf(address) ]); return walletBalance + stakedBalance; } Collab.Land approach comparison
| Feature | Standard rules | Custom API | Miniapp |
|---|---|---|---|
| Setup time | 1-2 hours | 2-3 days | 1-2 days |
| Logic complexity | Simple (balances) | Medium (webhook) | High (TypeScript) |
| Multi-wallet support | No | Yes | Yes |
| Cost | Free | Subscription | Subscription |
| Flexibility | Low | High | Maximum |
Collab.Land is a mature tool that covers most token-gating scenarios without building your own infrastructure. Custom API is only justified for specific logic like multi-wallet aggregation or complex DeFi positions.
Contact us for a turnkey integration—get a consultation for your project. We'll evaluate the solution in 1 day and propose the optimal architecture.







