Skip to main content
Get started with LeadMagic in minutes. This guide walks you through making your first API call and exploring our interactive playground.
Fastest way to start: Skip the code and use our API Playground - test any endpoint directly in your browser!

Step 1: Get Your API Key

1

Create an account

Sign up for free or log in if you already have an account.
2

Navigate to API Settings

Go to Settings > API in your dashboard.
3

Copy your API key

Click the copy button to copy your API key to clipboard.
Keep your API key secret. Never expose it in client-side code or public repositories.

Step 2: Try the API Playground

The fastest way to test LeadMagic is our interactive API Playground. No code required!

How to Use the Playground

1

Go to any API Reference page

Click any endpoint in the sidebar or the cards above.
2

Enter your API key

Paste your API key in the authentication section.
3

Fill in the parameters

Enter test data (e.g., an email to validate).
4

Click 'Send'

See the live response immediately!
The playground shows you exactly what your code will return - perfect for testing before integration.

Step 3: Make Your First API Call

Ready to integrate? Here’s how to call the API from your code:
curl -X POST 'https://api.leadmagic.io/v1/people/email-validation' \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"email": "test@leadmagic.io"}'

Example Response

{
  "status": "valid",
  "email": "test@leadmagic.io",
  "domain": "leadmagic.io",
  "credits_consumed": 0.05,
  "company": {
    "name": "LeadMagic",
    "domain": "leadmagic.io",
    "linkedin_url": "https://linkedin.com/company/leadmagichq"
  }
}
Bonus: Every email validation includes free company enrichment data!

Step 4: Explore More Endpoints

Now that you’ve made your first call, explore other powerful endpoints:

Common Use Cases

Goal: Remove invalid emails before a campaign
  1. Loop through your email list
  2. Call Email Validation for each
  3. Keep only valid and valid_catch_all status
  4. Remove invalid, skip catch_all and unknown
Result: Higher deliverability, protected sender reputation
Goal: Get contact info for target accounts
  1. Start with company domains
  2. Use Role Finder to find decision-makers
  3. Use Email Finder for work emails
  4. Use Mobile Finder for phone numbers
Result: Complete contact list for outreach
Goal: Fill in missing CRM fields
  1. Export contacts with LinkedIn URLs
  2. Use Profile Search for full profiles
  3. Use Company Search for company data
  4. Import enriched data back to CRM
Result: Rich CRM data for better personalization

What’s Next?