Quick Start

June 29, 2026 · View on GitHub

Get your first CorpusIQ query running in under five minutes.

Prerequisites

  • A CorpusIQ account
  • At least one connected business tool (Gmail, Google Drive, Slack, Shopify, etc.)
  • A terminal with curl installed (for API usage)

Step 1: Sign Up

Create an account at corpusiq.io/register. You can sign up with Google, Microsoft, or email. No credit card is required for the free tier.

Step 2: Connect Your Tools

  1. After signing in, go to the Dashboard
  2. Click Connections in the sidebar
  3. Click Add Connection on any service you want to connect
  4. Complete the OAuth authorization flow

CorpusIQ uses read-only OAuth scopes -- it can search your data but never modify it. The exact permissions are displayed on the authorization screen.

Popular first connections:

  • Gmail -- Search your email history
  • Google Drive -- Query across documents and spreadsheets
  • Slack -- Search messages and threads
  • HubSpot -- Look up deals and contacts

Step 3: Get Your API Token

  1. In the Dashboard, go to Settings → API
  2. Click Generate Token
  3. Copy the token -- it will only be displayed once

Store the token securely. Never embed it in client-side code or commit it to version control.

# Store in an environment variable
export CORPUSIQ_TOKEN="your_token_here"

Step 4: Make Your First Query

Once your tools are connected and you have a token, you can query your data from the terminal, your backend, or any HTTP client.

Basic cURL Example

curl -X POST https://api.corpusiq.io/v1/query \
  -H "Authorization: Bearer $CORPUSIQ_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query": "Show me my 5 most recent emails about budgets"}'

Example Response

{
  "query_id": "qry_a1b2c3d4e5",
  "query": "Show me my 5 most recent emails about budgets",
  "results": [
    {
      "connector": "gmail",
      "source_label": "Gmail",
      "chunks": [
        {
          "chunk_id": "chnk_x1y2",
          "content": "Re: Q3 Budget Review  --  Sarah from Finance shared the updated budget spreadsheet. Please review by Friday.",
          "source_url": "https://mail.google.com/mail/u/0/#inbox/abc123",
          "relevance_score": 0.96,
          "metadata": {
            "subject": "Re: Q3 Budget Review",
            "from": "sarah@company.com",
            "date": "2026-06-15T09:30:00Z"
          }
        }
      ]
    }
  ],
  "search_summary": {
    "connectors_searched": 1,
    "total_chunks_found": 5,
    "duration_ms": 623
  }
}

Filter by Specific Connectors

curl -X POST https://api.corpusiq.io/v1/query \
  -H "Authorization: Bearer $CORPUSIQ_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "What are our top selling products this month?",
    "connectors": ["shopify"],
    "max_results": 10
  }'

Use Idempotency for Safe Retries

curl -X POST https://api.corpusiq.io/v1/query \
  -H "Authorization: Bearer $CORPUSIQ_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"query": "How many HubSpot deals closed this quarter?"}'

Using with AI Assistants

CorpusIQ is MCP-native. Connect it to your AI assistant to query your business tools in natural language:

  • ChatGPT: Install the CorpusIQ ChatGPT plugin or configure it as a Custom GPT Action
  • Claude: Add CorpusIQ as an MCP server in Claude Desktop or the Anthropic API
  • Perplexity: Connect via the Perplexity integrations dashboard

See the MCP Integration Guide for setup instructions.

Next Steps

Frequently Asked Questions

Q: How long does it take to set up CorpusIQ?
A: Under 5 minutes. Sign up at corpusiq.io, connect a data source via OAuth (60 seconds), generate an API token, and make your first query. No coding, no configuration files, no infrastructure to manage.

Q: Do I need a credit card to start?
A: No. The CorpusIQ free tier requires no credit card. Sign up with Google, Microsoft, or email and start connecting data sources immediately.

Q: What are the best data sources to connect first?
A: Start with Gmail (search email), Google Drive (query documents), HubSpot (CRM data), Slack (messages), or Shopify (orders). Each connection takes 60 seconds via OAuth.

Q: How do I get an API token?
A: Go to Dashboard → Settings → API, click Generate Token, and copy it. Store it securely as an environment variable. Tokens expire after 60 minutes with refresh detection.

Powered by CorpusIQ.