Quickstart

Create a token and run your first API request in minutes.

Start here

Create an access token and attach it to the Authorization header to make your first request.

Create a token

Open Developers → API in Sanka.
Click Create Token and choose the permission.
Save the Access Token somewhere secure (shown once).

Send your first request

Try fetching deals:

curl -X GET "https://api.sanka.com/v1/public/deals?page=1&limit=50" \
  -H "Authorization: Bearer <access_token>"

Or create a deal:

curl -X POST "https://api.sanka.com/v1/public/deals" \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{"company": "Acme Corp", "value": 50000, "stage": "discovery"}'

Notes:

There is no sandbox, so use a workspace with test data.
Keep your token in a secure store.

Use the SDK

Node.js / TypeScript

npm install sanka-sdk

import Sanka from 'sanka-sdk'

const sanka = new Sanka({
  apiKey: process.env['SANKA_API_KEY'],
})

const deals = await sanka.deals.list({
  page: 1,
  limit: 50,
})

console.log(deals.data)

Python

pip install sanka-sdk

from sanka_sdk import Sanka

sanka = Sanka(api_key="sk_...")

deals = sanka.deals.list(page=1, limit=50)

print(deals.data)

Use with AI agents

Add the Sanka MCP server to Claude Code, Cursor, or any MCP-compatible agent:

{
  "mcpServers": {
    "sanka": {
      "type": "url",
      "url": "https://mcp.sanka.com/mcp?apiKey=sk_test_xxx"
    }
  }
}

Once connected, you can ask your agent things like:

"Create a deal for Acme Corp, $50K, discovery stage"
"List all deals in negotiation"
"Send a follow-up to contacts who haven't been contacted this week"

The agent calls Sanka's MCP tools automatically.

Confirm the response

If the response includes data, you're good to go. Common issues:

401: token missing/expired
403: token permission is Regular (GET-only)
429: too many requests, retry later

Next, review authentication, the API reference, and the full developer guide.

PreviousDeveloper Home NextAuthentication