Skip to main content

​
Get your API key

1

Log into Roulette

Go to useroulette.com and sign in to your account.
2

Navigate to Settings

Click on your team name in the sidebar, then select Settings → API Keys.
3

Generate a new key

Click Create API Key, give it a name (e.g., “Development”), and copy the generated key.
Store your API key securely. It won’t be shown again!

​
Make your first request

Fetch companies from your deal pipeline: 
curl -X GET "https://www.useroulette.com/api/v1/companies" \
  -H "Authorization: Bearer YOUR_API_KEY"
You’ll receive a response like this: 
{
  "success": true,
  "data": {
    "companies": [
      {
        "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "name": "Acme Corp",
        "deck_link": "https://docsend.com/view/example",
        "source": "email",
        "company_status": {
          "status_text": "Initial Review",
          "color": "#3B82F6"
        },
        "metadata": {
          "ai_analysis": "B2B SaaS for workflow automation",
          "founders": [
            { "name": "Jane Smith", "title": "CEO" }
          ]
        }
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "has_next": true,
      "has_prev": false
    }
  }
}

​
Add a company with AI

The fastest way to add deals is the AI upload endpoint. Paste an email, a DocSend link, or any text - the AI extracts everything automatically: 
curl -X POST "https://www.useroulette.com/api/v1/companies/upload/ai" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "account_id=YOUR_ACCOUNT_ID" \
  -F "text=Hey, wanted to share our deck: https://docsend.com/view/abc123

We're building AI tools for sales teams. Currently at $50k MRR.

Best,
Jane Smith
CEO, TechStartup"
The AI automatically:
  • Extracts the DocSend URL and downloads the deck
  • Detects this came from an email (sets source: "email")
  • Creates the company record with the extracted name
Find your account_id in your dashboard URL: useroulette.com/home/{account_id}/...

​
Analyze a pitch deck

Already have a company in your pipeline? Use AI to extract structured data from the deck: 
curl -X POST "https://www.useroulette.com/api/v1/companies/{company_id}/analyze" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
This populates metadata.founders, metadata.ai_analysis, and your custom fields.
AI operations (upload/ai and analyze) consume credits from your account. You receive 500 credits/month with your subscription.

​
Next steps

Companies API

Full CRUD operations for your pipeline

Pipeline Statuses

Manage deal flow stages

Dashboard API

Pipeline metrics and statistics

Emails API

Access ingested emails