Quickstart

Send your first email

1. Get your API key

   Log in to the Venmail dashboard and navigate to Settings > API Keys. Click Create API Key, give it a name, and copy the key. You’ll only see it once.

2. Verify your domain

   Go to Settings > Domains and add your sending domain. Add the DNS records shown (SPF, DKIM, return path). See Domain Setup for details.

3. Send a test email

   curl

   curl -X POST https://m.venmail.io/api/v1/send/message \
     -H "X-Server-API-Key: YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "to": ["[email protected]"],
       "from": "[email protected]",
       "subject": "Hello from Venmail",
       "html_body": "<h1>It works!</h1><p>Your first Venmail email.</p>"
     }'

   Node.js

   import { venmailSend } from '@venmail/vsm';
   
   // Or use fetch directly:
   const res = await fetch('https://m.venmail.io/api/v1/send/message', {
     method: 'POST',
     headers: {
       'X-Server-API-Key': 'YOUR_API_KEY',
       'Content-Type': 'application/json',
     },
     body: JSON.stringify({
       to: ['[email protected]'],
       from: '[email protected]',
       subject: 'Hello from Venmail',
       html_body: '<h1>It works!</h1>',
     }),
   });
   
   console.log(await res.json());

   PHP

   $ch = curl_init('https://m.venmail.io/api/v1/send/message');
   curl_setopt_array($ch, [
       CURLOPT_POST => true,
       CURLOPT_RETURNTRANSFER => true,
       CURLOPT_HTTPHEADER => [
           'X-Server-API-Key: YOUR_API_KEY',
           'Content-Type: application/json',
       ],
       CURLOPT_POSTFIELDS => json_encode([
           'to' => ['[email protected]'],
           'from' => '[email protected]',
           'subject' => 'Hello from Venmail',
           'html_body' => '<h1>It works!</h1>',
       ]),
   ]);
   
   $response = curl_exec($ch);
   echo $response;

4. Check the response

   A successful response looks like:

   {
     "status": "success",
     "data": {
       "message_id": "[email protected]",
       "messages": {
         "[email protected]": { "id": 1234, "token": "abcdef" }
       }
     }
   }

Try it now

Not authenticated

Login with Venmail

POST Send

Body Headers cURL

{ "to": ["user@example.com"], "from": "hello@yourdomain.com", "subject": "Test email", "html_body": "<p>Hello from Venmail API!</p>" }

X-Server-API-Key

Content-Type

Copy

Response

Next steps

• Send with custom headers for tracking and routing
• Set up webhooks for delivery events
• Enable VVS-1 signing for cryptographic message verification
• Install the Node.js or PHP SDK