Skip to main content

​
Authentication

All API requests and the MCP server require a Bearer token. API keys are scoped to a specific business with configurable permissions.

​
Create an API Key

1

Open Settings

Navigate to Settings → API Keys in your Cortana AI dashboard.
2

Generate New Key

Click Generate New Key. Give it a name (e.g., “MCP Server” or “Dashboard”).
3

Select Scopes

Enable the scopes you need. For full MCP access, enable all read scopes.
4

Copy the Key

Your key starts with sk-ak-. Copy it immediately — it won’t be shown again.

​
Using the API Key

curl -H "Authorization: Bearer sk-ak-your-api-key" \
  https://app.usecortana.ai/api/v1/businesses/{businessId}/contacts

​
Available Scopes

ScopeAccess
contacts:readList and search contacts
contacts:writeCreate, update, delete contacts
conversations:readList conversations, read messages, call logs
conversations:writeUpdate conversation metadata
messages:readRead message history
messages:writeSend messages
agents:readList and view agent configurations
agents:writeCreate, update, delete agents
appointments:readList and view appointments
appointments:writeCreate, update, delete appointments
conversions:readView conversion entries and configs
conversions:writeCreate conversion entries
tracking:readView tracking sessions
tags:read / tags:writeManage tags
custom_fields:read / custom_fields:writeManage custom fields
attribution:readFull attribution table, UTMs, presets, LTV
stripe:readStripe payments, subscriptions, customers, metrics
shopify:readShopify orders, customers, products, analytics
whop:readWhop payments, customers, memberships

​
Find Your Business ID

Your Business ID is in your dashboard URL: 
https://app.usecortana.ai/business/cf3383a0-55f6-45d8-ab57-484edd63770c/tracking
                                     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
                                     This is your Business ID