Skip to main content

Documentation Index

Fetch the complete documentation index at: https://lava.so/docs/llms.txt

Use this file to discover all available pages before exploring further.

Inbound email infrastructure for AI agents — receive emails on a custom domain and get structured webhook payloads with parsed content, attachments, and authentication results (SPF/DKIM/DMARC). Best for agent workflows that need to process incoming emails programmatically. Unlike outbound email services (SendGrid, Mailgun), Primitive handles the receiving side with webhook delivery and automatic retries. 1 example endpoint available through Lava’s AI Gateway. See the Primitive API docs for full documentation.
This provider requires your own credentials — connect your API key or OAuth account before use.
This is a catch-all provider — any valid URL under https://api.primitive.dev is supported. Inbound email API. Construct URL as https://api.primitive.dev/{path}. The endpoints below are curated examples.

​
Endpoints

​
Webhook payload delivered when email is received (configure your endpoint URL in dashboard)

POST https://api.primitive.dev/webhooks — Free / request 
const data = await lava.gateway('https://api.primitive.dev/webhooks', {
  body: {
"event": "email.received",
"email": {
  "subject": "Hello",
  "from": "sender@example.com"
}
},
});

​
Next Steps

All Providers

Browse all supported AI providers

Forward Proxy

Learn how to construct proxy URLs and authenticate requests