Fuul
  • INTRO
    • ⚑What is Fuul?
    • πŸ’ͺWhy use Fuul?
    • πŸ€”Use Cases
    • βš™οΈIntegration
    • πŸ”—Main Links
  • HOW IT WORKS
    • πŸ’ΈTypes of Rewards
    • βœ…Conversion Events
      • 1️⃣CLAMM LPs (e.g. Uniswap V3)
      • 2️⃣Constant LPs (e.g., Uniswap V2)
      • 3️⃣Lending & Borrowing
      • 4️⃣Staking
      • 5️⃣Token Holders
      • 6️⃣Custom Onchain Events
      • 7️⃣Custom Offchain Events
  • πŸ€‘Incentive Payouts
    • πŸ—ΏFixed Rewards
    • 🌊Variable Rewards
    • πŸ’°Pool Distribution
  • πŸ§‘β€πŸ€β€πŸ§‘Referrals
  • ♾️Attribution Methods
  • πŸ’²Budgets
  • ⚑Fuul Incentives Manager
  • πŸŽ–οΈLeaderboards
  • πŸ’»Incentives Hub
    • πŸ‘¨β€πŸ’»White-Label Implementation
    • πŸ‘No-Code
  • FOR DEVS
    • ⭐Getting started with Fuul Web SDK
    • βš™οΈSending Custom Events through the API
    • πŸ“„Tracking referrals in your app
    • πŸ‘¨β€πŸ’»API Key Management
    • πŸ› οΈBuilding your incentives hub in your app (white-label)
      • ℹ️Getting all incentives information
      • πŸ”—Creating affiliate links or codes
      • πŸ’―Getting Leaderboard Data
        • πŸͺ™Tokens
        • 🌟Points
      • πŸ™‹Getting Individual Rewards
        • πŸͺ™Tokens
        • 🌟Points
      • πŸ€™Claiming Onchain Rewards
    • πŸ”§Building widgets
    • πŸ“’Managing Audiences and Segments
      • πŸ‘€Getting User Audiences using Fuul SDK
      • πŸ‘₯Updating Audience Segments using Fuul API
    • ✈️Migration from older SDK versions
    • πŸ†˜Troubleshooting
  • PROTOCOL
    • ⛓️Smart Contracts
    • 🧡Subgraphs
  • Guides
    • ✏️Getting Started
      • Creating Your First Incentive Program
      • How to Add a Budget in Fuul
  • 🏁Creating Triggers & Conversions
    • Understanding Triggers Types
    • Creating an Event with CSV file
  • 🎨Program Incentive Page
    • Building no code landing pages
  • πŸ“ŠAnalytics
    • Understanding Sybil Detection
Powered by GitBook
On this page
  1. FOR DEVS

API Key Management

PreviousTracking referrals in your appNextBuilding your incentives hub in your app (white-label)

Last updated 4 months ago

Fuul provides four types of API keys, each tailored to specific use cases based on your project’s requirements. These keys enable secure interaction with the Fuul platform and should be used appropriately to ensure data integrity and system security.

1. Read-Only

The Read-Only API Key is used to fetch data for display purposes, such as in front-end applications. For example, this key is ideal for showing a leaderboard or displaying information about conversions and rewards on your website. It only retrieves information and cannot modify or send data.

2. send:tracking_event

The send:tracking_event API Key is also suitable for front-end use. In addition to showing information about conversions and rewards, it allows you to send tracking events like pageview or connect_wallet. This key is designed to interact with basic user activity data while maintaining security.

3. send:trigger_event

The send:trigger_event API Key is exclusively for back-end use. It allows you to send and receive custom trigger events and conversions, such as actions performed in Twitter or Discord communities.

Do not use this key in the front-end, as exposing it could allow malicious users to send false events, compromising the integrity of your program.

4. service_role

The service_role API Key is used for creating or updating program information, specifically for audience management.

This key is strictly for back-end operations and should never be exposed in the front-end.

Use these API keys based on your project’s specific needs, ensuring they are implemented securely and in line with their intended purpose.

Creating your API Key

To create an API key go to Settings > New API Key

Then select the type of API Key you want to create, name it and hit Create.

You will see a modal with your new API Key. Make sure to copy it.

For more details on managing audiences, visit .

πŸ‘¨β€πŸ’»
this page