primitiveBeta
primitive app

finally,
email is a developer primitive.

$npm install @primitivedotdev/sdk

email as the communication layer it was meant to be

Get StartedDashboard
Read Docs
@primitivedotdev
the code
import {
  confirmedHeaders,
  handleWebhook,
  PrimitiveWebhookError,
} from '@primitivedotdev/sdk';


export async function POST(req: Request) {
  const body = await req.text();


  try {
    const event = handleWebhook({
      body,
      headers: req.headers,
      secret: process.env.PRIMITIVE_WEBHOOK_SECRET!,
    });


    console.log('Event:', event.id);
    console.log('Email from:', event.email.headers.from);
    console.log('Subject:', event.email.headers.subject);


    return Response.json(
      { received: true },
      { headers: confirmedHeaders() }
    );
  } catch (error) {
    if (error instanceof PrimitiveWebhookError) {
      return Response.json({ error: error.code }, { status: 400 });
    }


    throw error;
  }
}
the webhook json
1{
2  "id": "evt_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",
3  "event": "email.received",
4  "version": "2025-12-14",
5  "delivery": {
6    "endpoint_id": "ep_abc123def456",
7    "attempt": 1,
8    "attempted_at": "2025-12-18T12:00:00.000Z"
9  },
10  "email": {
11    "id": "em_e1a2b3c4-d5e6-7f8a-9b0c-1d2e3f4a5b6c",
12    "received_at": "2025-12-18T12:00:00.000Z",
13    "smtp": {
14      "helo": "mail.example.com",
15      "mail_from": "[email protected]",
16      "rcpt_to": [
17        "[email protected]"
18      ]
19    },
20    "headers": {
21      "message_id": "<[email protected]>",
22      "subject": "Hello from primitive",
23      "from": "Sender Name <[email protected]>",
24      "to": "[email protected]",
25      "date": "Wed, 18 Dec 2025 12:00:00 +0000"
26    },
27    "content": {
28      "raw": {
29        "included": true,
30        "encoding": "base64",
31        "max_inline_bytes": 262144,
32        "size_bytes": 1024,
33        "sha256": "a1b2c3d4...",
34        "data": "RnJvbTogc2VuZGVyQGV4YW1wbGUuY29t..."
35      },
36      "download": {
37        "url": "https://api.primitive.dev/v1/downloads/raw/token",
38        "expires_at": "2025-12-19T12:00:00.000Z"
39      }
40    },
41    "parsed": {
42      "status": "complete",
43      "error": null,
44      "body_text": "Hello! This is a test email from primitive.",
45      "body_html": "<p>Hello! This is a test email from primitive.</p>",
46      "attachments": [
47        {
48          "filename": "document.pdf",
49          "content_type": "application/pdf",
50          "size_bytes": 24576,
51          "sha256": "b2c3d4e5f6...",
52          "part_index": 0,
53          "tar_path": "0_document.pdf"
54        }
55      ],
56      "attachments_download_url": "https://api.primitive.dev/v1/downloads/attachments/token"
57    },
58    "analysis": {
59      "spamassassin": {
60        "score": 2
61      }
62    }
63  }
64}
Get StartedDashboard
Read Docs
@primitivedotdev