QUICKSTART

Zero to Working in 5 Minutes

Get your API key, make your first call, and see SolidNumber working. One page. No fluff.

Get Your API Key

Log into your dashboard and create an API key:

Dashboard → Integrations → API → Create Key → Copy the sk_solid_... key

Or use the CLI (pick whichever you trust):

# macOS / Linux
brew install solidnumber/tap/cli

# Windows
scoop bucket add solidnumber https://github.com/Solidnumber/scoop-bucket
scoop install solidnumber/solid

# any platform with Node 20+
npm i -g @solidnumber/cli

solid auth login
solid auth token create -n "My App"

Make Your First API Call

List your contacts:

curl -X GET https://api.solidnumber.com/api/v1/crm/contacts \
  -H "Authorization: Bearer sk_solid_your_api_key" \
  -H "Content-Type: application/json"

Response:

{
  "contacts": [
    {
      "id": 1,
      "first_name": "John",
      "last_name": "Smith",
      "email": "john@example.com",
      "phone": "+18015551234",
      "source": "website",
      "lead_temperature": "warm"
    }
  ],
  "total": 1
}

Create a Contact

curl -X POST https://api.solidnumber.com/api/v1/crm/contacts \
  -H "Authorization: Bearer sk_solid_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "Jane",
    "last_name": "Doe",
    "email": "jane@example.com",
    "phone": "+18015559876",
    "source": "api"
  }'

Talk to ADA (AI Assistant)

Send a message to your AI assistant:

curl -X POST https://api.solidnumber.com/api/v1/chat/message \
  -H "Authorization: Bearer sk_solid_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "How many leads did I get this week?",
    "conversation_id": "quickstart-test"
  }'

Response:

{
  "text": "You got 4 new leads this week — 2 from your website,
           1 from Thumbtack, and 1 from a phone call. The website
           lead from Tuesday looks hot — they viewed your pricing
           page 3 times. Want me to follow up?",
  "meta": {
    "model": "claude-sonnet-4-6",
    "tokens_used": 847
  }
}