Skip to main content
POST
/
public
/
v1
/
templates
/
email
/
send
Python
import requests

url = 'https://api.minimo.it/public/v1/templates/email/send'
headers = {'Authorization': 'Bearer {{BEARER_TOKEN}}', 'Content-Type': 'application/json'}
data = {
    'recipient': '{{recipient}}',
    'uid': '{{uid}}',
    'customFields': {
        '{{customKey1}}': '{{customValue1}}',
        '{{customKey2}}': '{{customValue2}}',
        '{{customKey3}}': '{{customValue3}}'
    }
}
response = requests.post(url, json=data, headers=headers)
print(response.json())
{
  "data": {
    "status": 200,
    "success": true,
    "messageId": "0100019c8b3d4a4f-a1b2c3d4-e5f6-7a8b-9c0d-e1f2a3b4c5d6-000000"
  }
}

​
Overview

Use this endpoint to send emails based on templates you’ve created in the Minimo dashboard. Perfect for:
  • Transactional emails: Order confirmations, password resets, receipts
  • Automated messages: Welcome series, onboarding flows
  • Triggered notifications: Account alerts, status updates
This API is intended for server-side usage only. Requests from client-side applications will be blocked for security reasons.

​
Before You Start

  1. Create a template in the Minimo dashboard under Templates → Email
  2. Get the template ID from the templates list
  3. Define custom fields in your template using {{variableName}} syntax
  4. Test your template using the dashboard preview before API integration

​
Template Variables

Templates support dynamic content using variables: Template Example: 
Hello {{firstName}}, Your order {{orderNumber}} has been confirmed! Total: {{orderTotal}} Estimated delivery:
{{deliveryDate}}
API Request: 
{
  "uid": "tmpl_abc123",
  "recipient": "customer@example.com",
  "customFields": {
    "firstName": "Jane",
    "orderNumber": "ORD-12345",
    "orderTotal": "$99.99",
    "deliveryDate": "November 20, 2025"
  }
}

​
Use Cases

Send instant confirmation when an order is placed:
{
  "uid": "tmpl_order_confirm",
  "recipient": "customer@example.com",
  "customFields": {
    "orderNumber": "ORD-12345",
    "items": "3 items",
    "total": "$149.99",
    "trackingUrl": "https://track.example.com/12345"
  }
}
Send password reset links securely:
{
  "uid": "tmpl_password_reset",
  "recipient": "user@example.com",
  "customFields": {
    "resetLink": "https://app.example.com/reset?token=abc123",
    "expiresIn": "24 hours"
  }
}
Onboard new users with a welcome message:
{
  "uid": "tmpl_welcome",
  "recipient": "newuser@example.com",
  "customFields": {
    "firstName": "John",
    "loginUrl": "https://app.example.com/login",
    "supportEmail": "support@example.com"
  }
}

​
Best Practices

​
Email Deliverability

To improve deliverability: - Use verified sender domains in Minimo dashboard - Avoid spam trigger words in templates - Include unsubscribe links for marketing emails - Test with email testing tools before production

​
Template Design

  • Keep it simple: Plain text or simple HTML works best
  • Test responsiveness: Templates should work on mobile devices
  • Include branding: Add your logo and brand colors
  • Clear call-to-action: Make buttons and links obvious

​
Error Handling

Always handle potential errors: 
try {
  const response = await fetch('https://api.minimo.it/public/v1/templates/email/send', {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${apiKey}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      uid: 'tmpl_abc123',
      recipient: 'customer@example.com',
      customFields: { name: 'Jane' },
    }),
  });

  if (!response.ok) {
    const error = await response.json();
    console.error('Email send failed:', error);
    // Log error, retry, or notify admin
  }
} catch (error) {
  console.error('Network error:', error);
  // Handle network issues
}

​
Common Errors

ErrorCauseSolution
template_not_foundInvalid template IDVerify template ID in dashboard
invalid_recipientInvalid email addressValidate email format before sending
missing_custom_fieldTemplate variable not providedInclude all required custom fields
rate_limit_exceededToo many requestsImplement rate limiting, use queues
sender_not_verifiedEmail domain not verifiedVerify sender domain in dashboard

​
Tracking & Analytics

After sending, track email performance:
  • Delivery status: Check if email was delivered
  • Open rate: See who opened your emails
  • Click rate: Track link clicks in your templates
  • Bounce rate: Monitor bounced emails
Access analytics in the Minimo dashboard or via the Get Email Template Stats endpoint.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

​
recipient
string
required

Email address of the recipient

​
uid
string
required

UID of the transactional email

​
customFields
object

Custom fields specific to the email

Response

Successful response

​
data
object