​
Get Your API Key

To get started with the Tuesday Leads API, you’ll need an API key:

1

Sign Up

Create an account at Tuesday Dashboard

2

Generate API Key

Navigate to the API Keys section and generate a new key

3

Secure Your Key

Store your API key securely - treat it like a password

Never expose your API key in client-side code or public repositories. Always use environment variables or secure key management systems.

​
Test Your Setup

Verify your API key works by making a test request to the Auth API:

curl --location 'https://api.tuesday.so/api/v1/public/auth' \
--header 'X-API-KEY: your-api-key-here'

Expected Response:

{
    "data": {
        "name": "Your Workspace",
        "id": "ws30ngrb03luqxcl27",
        "user_id": "usr19g6tln8rlii8"
    },
    "statusCode": 200,
    "message": "Success"
}

​
Your First API Call

Let’s fetch a person’s profile using their LinkedIn URL:

curl --location 'https://api.tuesday.so/api/v1/people/profile?linkedin_url=https://www.linkedin.com/in/david-addiss-4725189' \
--header 'X-API-KEY: your-api-key-here'

Response:

{
    "data": {
        "name": "David Addiss",
        "first_name": "David",
        "last_name": "Addiss",
        "title": "Energy Consultant",
        "city": "St Petersburg",
        "state": "Florida",
        "country": "United States",
        "linkedin_url": "https://www.linkedin.com/in/david-addiss-4725189",
        "organizations.name": "Semper Solaris",
        "organizations.website_url": "https://www.sempersolaris.com"
    },
    "statusCode": 200,
    "message": "Success"
}

​
Common Use Cases

CRM Enrichment

Enrich your existing contacts with additional profile data and verified contact information.

Lead Generation

Find and qualify new prospects using company and people search APIs.

Sales Intelligence

Research prospects and companies before outreach with detailed profiles and insights.

Market Research

Analyze companies and their employees to understand market trends and opportunities.

​
Best Practices

Start Small: Begin with basic profile lookups before moving to advanced search queries

Batch Requests: For multiple profiles, consider the rate limits and plan your requests accordingly

Cache Results: Store frequently accessed data to reduce API calls and improve performance

Error Handling: Always implement proper error handling for API timeouts and rate limits

​
Next Steps

Now that you’re set up, explore these key areas:

​
Need Help?

API Reference

Complete API documentation with examples