This guide takes you from a new ConvertNow account to a delivered email in under 5 minutes.
Step 1: Create an account
Go to https://convertnow.co and sign up. Once logged in, navigate to Email API in the left sidebar.
Step 2: Create an API key
1. Click + New Key
2. Give it a name (e.g. “My App”)
3. Click Create
4. Copy the key immediately — it is shown only once
Store it as an environment variable:
export CONVERTNOW_API_KEY=cn_live_YOUR_KEY
Step 3: Send your first email via HTTP
curl -X POST https://api.convertnow.co/v1/email/send \
-H “Authorization: Bearer cn_live_YOUR_KEY” \
-H “Content-Type: application/json” \
-d ‘{
“to”: “[email protected]”,
“subject”: “Hello from ConvertNow”,
“html”: “<h1>It works!</h1>”
}’
Response:
{ “id”: “msg_abc123”, “status”: “sent”, “message”: “Email queued for delivery” }
Step 4: Send via SMTP
Setting | Value |
Host | out.convertnow.co |
Port | 465 (implicit SSL) or 25 / 2525 (STARTTLS) |
Username | your email address |
Password | cn_live_YOUR_KEY |
Step 5: Verify delivery
Open the Send Logs tab on the Email API page. Every send — HTTP or SMTP — appears here with its status, recipient, and timestamp.
Language quickstarts
Node.js
const res = await fetch(‘https://api.convertnow.co/v1/email/send’, {
method: ‘POST’,
headers: { ‘Authorization’: ‘Bearer cn_live_YOUR_KEY’, ‘Content-Type’: ‘application/json’ },
body: JSON.stringify({ to: ‘[email protected]’, subject: ‘Hello’, html: ‘<p>Hello!</p>’ }),
});
console.log(await res.json());
Python
import requests
r = requests.post(
‘https://api.convertnow.co/v1/email/send’,
headers={‘Authorization’: ‘Bearer cn_live_YOUR_KEY’},
json={‘to’: ‘[email protected]’, ‘subject’: ‘Hello’, ‘html’: ‘<p>Hello!</p>’}
)
print(r.json())
Next steps
• Authenticate your sending domain — add DKIM, SPF, and DMARC
• Set up webhooks — receive real-time delivery and failure events
• Manage your suppression list — handle unsubscribes and bounces
• Full API reference — complete endpoint documentation