> For the complete documentation index, see [llms.txt](https://layer3xyz.gitbook.io/layer3-updated-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://layer3xyz.gitbook.io/layer3-updated-docs/builder/guides/guides--action-types-reference.md).

# Action Types Reference

### User Identity & Proof of Humanity

Verify user connections and on-platform achievements.

<figure><img src="https://752488452-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhSilmqBx7U8CtP2hlByI%2Fuploads%2FAde0FqjfMN3mJzl7BEKR%2FScreenshot%202025-06-10%20at%2016.00.48.png?alt=media&#x26;token=b2d82a09-63a2-4ab4-8e62-a431f5928283" alt=""><figcaption></figcaption></figure>

#### `ENS Imported`

**What it does:** Verifies a user has connected an ENS name to their Layer3 profile.

**Best for:** Building crypto-native communities. Quality user filtering. Pre-qualifying engaged Ethereum users

**Usage tips:** Place early in activation sequences as a simple qualifier. Combine with other identity verifiers for stronger authentication. Great filter for ethereum-focused campaigns. Can indicate higher-value wallets/users.

#### `Gitcoin Passport Score`

**What it does:** Verifies a user's [Gitcoin Passport](https://app.passport.xyz/) score.

**Best for:** Filtering for high-quality participants, preventing sybil.

**Usage tip:** Set score threshold based on your needs. Higher for exclusive drops, lower for broader participation.

#### `CUBEs Minted`

**What it does:** Checks how many CUBEs a user has minted (optionally on specific chains).

**Best for:** Rewarding platform activity, creating loyalty tiers.

**Usage tip:** Great for targeting/segmenting experienced Layer3 users by network, or creating exclusive activations. E.g. must have 50 CUBEs on OP Mainnet to participate.

#### `Social Connections`

**What it does:** Verifies user has connected accounts (Twitter, Discord, Telegram, Email, Github).

**Best for:** Building verified community lists, ensuring real users.

**Usage tip:** Use in early activation steps to build quality user data.

***

### Informational

Share knowledge and educate users.

<figure><img src="https://752488452-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhSilmqBx7U8CtP2hlByI%2Fuploads%2FN1mQv5QEMbCMTMcVDzde%2FScreenshot%202025-06-10%20at%2016.03.40.png?alt=media&#x26;token=b454f4dc-8622-404c-a474-d3c6dc6f5110" alt=""><figcaption></figcaption></figure>

#### `Info Cards`

**What it does:** Displays information, images, and links to users.

**Best for:** Product education, feature announcements, protocol explanations.

**Usage tip:** Keep content concise and include visual elements when possible. **If you use visual elements, try adding only one or two lines of text to ensure everything displays properly on smaller screens.**

***

### Social Engagement

Build community presence.

<figure><img src="https://752488452-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhSilmqBx7U8CtP2hlByI%2Fuploads%2FDycoULnND6wEWmM81n0d%2FScreenshot%202025-06-10%20at%2016.09.02.png?alt=media&#x26;token=23819353-8130-4ffa-a7b9-2ed0cec4424d" alt=""><figcaption></figcaption></figure>

#### `Join Telegram Group`

**What it does:** Verifies that a user has joined your specified Telegram group and connected their Telegram account to Layer3.

**Best for:** Growing Telegram communities. Enabling direct user communication. Creating active discussion channels. Time-sensitive announcements

**Usage tip:** Add a "Telegram Connected" step before this. Place early in activation sequences to maintain engagement throughout the campaign. Add Info Card before to explain group value and guidelines.

<mark style="background-color:yellow;">**Important:**</mark> <mark style="background-color:yellow;">Add the Layer3 bot to your Telegram server. This is how how we'll verify if users actually joined:</mark> [<mark style="background-color:yellow;">https://t.me/Layer3Bot?startgroup=true</mark>](https://t.me/Layer3Bot?startgroup=true)

#### `Join Discord Server`

**What it does:** Verifies that a user has joined your specified Discord server and connected their Discord account to Layer3.

**Best for:** Building long-term communities. Creating role-based access. Supporting detailed discussions. Project governance participation

**Usage tip:** Add a "Discord Connected" step before this. Consider creating a dedicated channel for activation participants. Discord integration enables future role-gating and targeted campaigns.

<mark style="background-color:yellow;">**Important:**</mark> <mark style="background-color:yellow;">Add the Layer3 bot to your Discord server. This is how how we'll verify if users actually joined:</mark> [<mark style="background-color:yellow;">https://discord.com/api/oauth2/authorize?client\_id=942680509056692245\&permissions=0\&scope=bot</mark>](https://discord.com/api/oauth2/authorize?client_id=942680509056692245\&permissions=0\&scope=bot)

***

### Quiz & Poll

Gather feedback and verify understanding.

<figure><img src="https://752488452-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhSilmqBx7U8CtP2hlByI%2Fuploads%2FEAohGcOy8AuyDYYWu05o%2FScreenshot%202025-06-10%20at%2016.12.34.png?alt=media&#x26;token=d97a14fd-2831-4e5d-80f9-191e63350e54" alt=""><figcaption></figcaption></figure>

#### `Quiz`

**What it does:** Tests user knowledge with multiple-choice questions.

**Best for:** Ensuring product understanding, educational campaigns.

**Usage tip:** Use after Info Cards to verify comprehension.

#### `Polls`

**What it does:** Gathers user opinions via multiple choice or open response.

**Best for:** Community feedback, governance participation.

**Usage tip:** Great for research and showing users their voice matters. Poll results can be exported.

***

### Wallet Networks & Apps

Verify wallet connections and usage.

<figure><img src="https://752488452-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhSilmqBx7U8CtP2hlByI%2Fuploads%2FCSFZpFHyjOz2pmY7qVu6%2FScreenshot%202025-06-10%20at%2016.14.02.png?alt=media&#x26;token=8cfb7a9e-9629-4381-9039-b070266c2924" alt=""><figcaption></figcaption></figure>

#### `Specific Wallet Apps`

**What it does:** Verifies use of particular wallet applications.

**Best for:** Wallet adoption campaigns, partner integrations.

**Usage tip:** Combine with educational content about wallet features.

***

### Onchain Actions

Verify blockchain activity.

<figure><img src="https://752488452-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhSilmqBx7U8CtP2hlByI%2Fuploads%2Fbzk9DvzPrV0s0wgpjwXD%2FScreenshot%202025-06-10%20at%2016.14.52.png?alt=media&#x26;token=d8d5115f-5648-4073-b749-86a9e92a6671" alt=""><figcaption></figcaption></figure>

#### `Advanced Onchain Action`

**What it does:** Highly configurable, verifies any specified onchain action.

**Best for:** Engaging users with your protocol, proving usage.

**Usage tip:** Be specific about expected actions and test thoroughly.

<mark style="background-color:yellow;">**Note:**</mark> <mark style="background-color:yellow;">see</mark> <mark style="background-color:yellow;">Advanced Onchain Action Configuration</mark> <mark style="background-color:yellow;">for a detailed guide.</mark>

#### `Interact with EVM Contract`

**What it does:** Verifies that a user has interacted with a specific smart contract on any EVM chain. Can be configured to check for specific method calls and date ranges.

**Best for:** Verifying protocol usage. Tracking feature adoption. Validating governance participation. Proof of transaction history

**Usage tip:** Use the optional Method ID to verify specific actions (e.g., staking, voting) and From Date to focus on recent interactions. Always test the verification with your own wallet first since contract interactions can be complex.

#### `Token/NFT Holdings`

**What it does:** Verifies asset ownership or balances.

**Best for:** Token-gated content, holder rewards.

**Usage tip:** Consider minimum thresholds on Token holdings for deeper engagement.

#### `Have POAP`

**What it does:** Checks for specific POAP ownership.

**Best for:** Event attendance verification, exclusive content.

**Usage tip:** Great for post-event engagement campaigns.

#### `Mint NFT`

**What it does:** Verifies that a user has minted a specific NFT (ERC721 or ERC1155) from a null address. Automatically detects token type and handles ERC1155 token IDs.

**Best for:** NFT launch campaigns. Tracking mint participation. Primary market engagement. Community collector verification.

**Usage tip:** Great for NFT drops where you want to verify users minted directly rather than purchased secondary. For ERC1155s, specify token ID when campaign targets specific editions.

#### `Token Transfers`

**What it does:** Verifies specific token movements.

**Best for:** Participation in token/NFT sales, community contributions.

**Usage tip:** Always include clear instructions about amounts and addresses.

***

### General Purpose

Utility actions for activation flow.

<figure><img src="https://752488452-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhSilmqBx7U8CtP2hlByI%2Fuploads%2FUABhDulIDszkhK2OO4BB%2FScreenshot%202025-06-10%20at%2016.17.11.png?alt=media&#x26;token=48a056b2-c827-4bbf-8757-3485164d4eef" alt=""><figcaption></figcaption></figure>

#### Visit Website / Open Link

**What it does:** Guides a user to visit a site you specify

**Best for:** Driving traffic, documentation review.

**Usage tip:** Use for important resources or landing pages.

#### Complete Activation Dependency

**What it does:** Requires completion of another specified activation.

**Best for:** Creating activation sequences, progressive engagement.

**Usage tip:** Build knowledge or activity progressions.

#### Time Gate

**What it does:** Adds specified waiting period with countdown

**Best for:** Ensuring sustained engagement.

**Usage tip:** Use sparingly - only when a time delay adds value.

#### Custom API Integration

**What it does:** Enables custom verification of anything in your system via API.

**Best for:** Bespoke verification needs, special integrations, offchain actions you need to ensure the user has taken.

**Usage tip:** See Custom API Integration for a full setup guide.

***

### Best Practices

#### Activation Design

* Start with easier actions to build momentum
* Mix action types to maintain engagement
* Use Info Cards before complex actions
* Keep total steps under 5 when possible
* Design compelling incentives. **Every Activation must have an incentive (token, points, NFT allowlist, raffle, etc.) to be approved.** Use token rewards if the activation requires the user to transact onchain.

#### User Experience

* Write clear, concise instructions
* Provide context for why each action matters
* Test activation flow before publishing
* Consider mobile users in design