Quickstart - MailKatana Docs

1. Get a workspace API key

MailKatana developer docs assume you already have a workspace-scoped API key. Use that same key for both the REST API and the MCP server.

2. Make your first REST request

Create a contact with a Bearer token:

curl -X POST https://api.mailkatana.com/v1/contacts/create \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "avery@example.com",
    "firstName": "Avery",
    "lastName": "Stone",
    "source": "docs-quickstart"
  }'

3. Verify MCP authentication and transport

MailKatana serves MCP over Streamable HTTP. Verify the endpoint with an initialize request:

curl -i -X POST https://api.mailkatana.com/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  --data '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

With a valid key you should get a JSON-RPC initialize response instead of a 401 error. If you omit the header and still get 401, that means the endpoint exists and auth is the missing piece.

Next steps

Continue with authentication for REST and MCP auth details.
Browse the REST API overview.
Follow the MCP quickstart if you are connecting Claude, Cursor, or another client.