Ready to start building with DRIP? Let’s get you up and running in 5 minutes! 🚀

​
TL;DR - Just Want to Code?

# 1. Get your API key from Admin > Developer > Project API
# 2. Replace YOUR_API_KEY and YOUR_REALM_ID below
# 3. Run this command

curl -X GET "https://api.drip.re/api/v1/realms/YOUR_REALM_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Step-by-Step (For Real This Time)

​
1. Get Your API Key (30 seconds)

1

Open DRIP Dashboard

Go to app.drip.re and log in
2

Navigate to Developer Portal

Click Admin → Developer in the sidebar
3

Create API Client

  • Click Project API tab
  • Click Create API Client
  • Give it a name like “My First App”
  • Select some scopes (start with realm:read and members:read)
  • Click Create
4

Copy Your Keys

Copy both the Client ID and Client Secret (you’ll need the secret)

​
2. Find Your Realm (Project) ID (15 seconds)

Your Realm ID is displayed in the dashboard header when you select your project:
1

Select Your Project

In the DRIP dashboard, make sure your project is selected from the project switcher
2

Copy Realm ID

Look at the dashboard header - your Realm ID is displayed there and can be copied directly

​
3. Make Your First Call (1 minute)

const DRIP_API_KEY = 'your_client_secret_here';
const REALM_ID = 'your_realm_id_here';

async function getDripData() {
  try {
    // Get your realm info
    const realm = await fetch(`https://api.drip.re/api/v1/realms/${REALM_ID}`, {
      headers: { 'Authorization': `Bearer ${DRIP_API_KEY}` }
    }).then(r => r.json());
    
    console.log('🎉 Your realm:', realm.name);
    
    // Get some members
    const members = await fetch(`https://api.drip.re/api/v1/realm/${REALM_ID}/members/search?type=drip-id&values=all`, {
      headers: { 'Authorization': `Bearer ${DRIP_API_KEY}` }
    }).then(r => r.json());
    
    console.log('👥 Member count:', members.data?.length || 0);
    
  } catch (error) {
    console.error('❌ Error:', error.message);
  }
}

getDripData();

​
What Just Happened? 🤔

You just:
  1. ✅ Authenticated with the DRIP API
  2. ✅ Retrieved your realm information
  3. ✅ Searched for members in your community
Not bad for 5 minutes! 🎉

​
What Can You Do Next?

Award Points to Members

Give your community members some points for being awesome

Search for Specific Members

Find members by Discord ID, wallet address, or username

Build a Simple Dashboard

Create your first DRIP-powered app

Member Management

Search, update, and manage community members effectively

​
Quick Examples for Vibe Coders

​
Award Points to a Member

// Find a member first
const members = await fetch(`https://api.drip.re/api/v1/realm/${REALM_ID}/members/search?type=username&values=cool_member`, {
  headers: { 'Authorization': `Bearer ${DRIP_API_KEY}` }
}).then(r => r.json());

if (members.data?.length > 0) {
  const memberId = members.data[0].id;
  
  // Give them 100 points
  const result = await fetch(`https://api.drip.re/api/v1/realm/${REALM_ID}/members/${memberId}/point-balance`, {
    method: 'PATCH',
    headers: { 
      'Authorization': `Bearer ${DRIP_API_KEY}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ tokens: 100 })
  }).then(r => r.json());
  
  console.log('💰 Points awarded!', result);
}

​
Search Members by Discord ID

const discordId = '123456789012345678'; // Their Discord user ID

const members = await fetch(`https://api.drip.re/api/v1/realm/${REALM_ID}/members/search?type=discord-id&values=${discordId}`, {
  headers: { 'Authorization': `Bearer ${DRIP_API_KEY}` }
}).then(r => r.json());

if (members.data?.length > 0) {
  const member = members.data[0];
  console.log(`Found: ${member.displayName} with ${member.pointBalances[0]?.balance || 0} points`);
} else {
  console.log('Member not found 😢');
}

​
Common “Oops” Moments 🤦‍♂️

​
You’re Ready! 🎯

That’s it! You now know enough to be dangerous with the DRIP API. Here’s what to explore next:

Build Your First App

Create a simple DRIP-powered application

Learn the Fundamentals

Understand DRIP’s data model and concepts

See More Examples

Copy-paste code for common tasks
Pro tip: Join our Discord community for help, tips, and to show off what you’re building! 🚀