NornWeave Documentation
NornWeave API Reference

NornWeave API Reference

NornWeave provides two ways to interact with your email data:

REST API
Traditional HTTP endpoints for all operations
MCP Integration
Model Context Protocol for AI clients

Authentication

/v1/* endpoints require API key auth when API_KEY is configured. Use either Authorization: Bearer <API_KEY> or X-API-Key: <API_KEY>.

/webhooks/* endpoints remain API-key-free so email providers can deliver webhook events and rely on provider-specific signature verification.

Base URL

The REST API is served at:

http://localhost:8000/v1

Quick Reference

Inboxes

MethodEndpointDescription
POST/v1/inboxesCreate an inbox
GET/v1/inboxes/{id}Get an inbox
DELETE/v1/inboxes/{id}Delete an inbox

Threads

MethodEndpointDescription
GET/v1/threads/{id}Get a thread (LLM-formatted)

Messages

MethodEndpointDescription
POST/v1/messagesSend a message
GET/v1/messages/{id}Get a message

Search

MethodEndpointDescription
POST/v1/searchSearch messages

Webhooks

MethodEndpointDescription
POST/webhooks/mailgunMailgun inbound
POST/webhooks/sendgridSendGrid inbound
POST/webhooks/sesAWS SES inbound