> ## Documentation Index
> Fetch the complete documentation index at: https://docs.minimo.it/llms.txt
> Use this file to discover all available pages before exploring further.
# Send Email (Deprecated)
**This endpoint is deprecated and will be removed on June 1, 2026.** Please migrate to the new [Send Email
Template](/api-reference/messaging-channels/email/send-template) endpoint.
## Why This Is Deprecated
This endpoint has been replaced with a more flexible and consistent API under **Messaging Channels**.
### What's Wrong With This Endpoint?
* Uses unclear naming (`uid` instead of `templateId`)
* Inconsistent with other channel APIs
* Limited error handling
* No support for advanced template features
### Use the New Endpoint Instead
**New endpoint**: `POST /api/templates/email/send`
[View new endpoint documentation →](/api-reference/messaging-channels/email/send-template)
## Migration
### Old Request (This Endpoint)
```json theme={null}
{
"uid": "unique_template_id",
"recipient": "customer@example.com",
"customFields": {
"name": "John Doe",
"orderNumber": "12345"
}
}
```
### New Request (Recommended)
```json theme={null}
{
"templateId": "tmpl_abc123",
"recipient": "customer@example.com",
"customFields": {
"name": "John Doe",
"orderNumber": "12345"
}
}
```
**Changes needed**:
1. Update endpoint URL: `/api/transactionals` → `/api/templates/email/send`
2. Rename `uid` → `templateId`
3. Update template IDs in your code (now prefixed with `tmpl_`)
## Migration Deadline
| Date | Status |
| ------------- | ---------------------------------- |
| November 2025 | Deprecated (still works) |
| June 1, 2026 | **Removed** (will return 410 Gone) |
You have until **June 1, 2026** to migrate. Plan your migration now to avoid service disruption.
## Need Help?
* [Migration Guide](/api-reference/legacy/introduction)
* [New Email API Docs](/api-reference/messaging-channels/email/send-template)
* [Contact Support](mailto:info@minimo.it)
## OpenAPI
````yaml post /api/transactionals
openapi: 3.1.0
info:
title: API Documentation
description: Documentation for transactional and subscribe APIs
version: 1.0.0
servers:
- url: https://app.minimo.it
security:
- bearerAuth: []
paths:
/api/transactionals:
post:
summary: Send transactional emails
operationId: sendTransactionalEmails
requestBody:
required: true
content:
application/json:
schema:
oneOf:
- type: object
properties:
recipient:
type: string
description: Email address of the recipient
uid:
type: string
description: UID of the transactional email
customFields:
type: object
additionalProperties: true
description: Custom fields specific to the email
required:
- recipient
- uid
- type: array
items:
type: object
properties:
recipient:
type: string
description: Email address of the recipient
uid:
type: string
description: UID for the transactional email
customFields:
type: object
additionalProperties: true
description: Custom fields specific to the email
required:
- recipient
- uid
examples:
- recipient: email@minimo.it
uid: ABCDE143
customFields:
customKey1: customValue1
customKey2: customValue2
customKey3: customValue3
multipart/form-data:
schema:
type: object
properties:
recipient:
type: string
format: email
description: Email address of the recipient
uid:
type: string
description: UID for the transactional email
customFields.*:
type: string
description: Custom field key-value pairs for the email
required:
- recipient
- uid
examples:
- recipient: email@minimo.it
uid: ABCDE143
customFields.customKey1: customValue1
customFields.customKey2: customValue2
customFields.customKey3: customValue3
application/x-www-form-urlencoded:
schema:
type: object
properties:
recipient:
type: string
format: email
description: Email address of the recipient
uid:
type: string
description: UID for the transactional email
customFields.*:
type: string
description: Custom field key-value pairs for the email
required:
- recipient
- uid
examples:
- recipient: email@minimo.it
uid: ABCDE143
customFields.customKey1: customValue1
customFields.customKey2: customValue2
customFields.customKey3: customValue3
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
status:
type: integer
examples:
- 200
'400':
description: Bad request
content:
application/json:
schema:
type: object
properties:
error:
type: string
examples:
- Missing recipient address
'500':
description: Internal server error
content:
application/json:
schema:
type: object
properties:
error:
type: string
examples:
- Internal server error
security:
- bearerAuth: []
x-codeSamples:
- lang: Python
source: >-
import requests
url = 'https://app.minimo.it/api/transactionals'
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())
- lang: JavaScript
source: >-
fetch('https://app.minimo.it/api/transactionals', {
method: 'POST',
headers: {
'Authorization': 'Bearer {{BEARER_TOKEN}}',
'Content-Type': 'application/json'
},
body: JSON.stringify({
'recipient': '{{recipient}}',
'uid': '{{uid}}',
'customFields': {
'{{customKey1}}': '{{customValue1}}',
'{{customKey2}}': '{{customValue2}}',
'{{customKey3}}': '{{customValue3}}'
}
})
}).then(response => response.json()).then(data =>
console.log(data));
- label: CLI
lang: cURL
source: |-
curl --request POST \
--url https://app.minimo.it/api/transactionals \
--header 'Authorization: Bearer {{BEARER_TOKEN}}' \
--header 'Content-Type: application/json' \
--data '{
"recipient": "{{recipient}}",
"uid": "{{uid}}",
"customFields": {
"{{customKey1}}": "{{customValue1}}",
"{{customKey2}}": "{{customValue2}}",
"{{customKey3}}": "{{customValue3}}"
}
}'
- lang: PHP
source: |
'https://app.minimo.it/api/transactionals',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS =>'{
"recipient": "{{recipient}}",
"uid": "{{uid}}",
"customFields": {
"{{customKey1}}": "{{customValue1}}",
"{{customKey2}}": "{{customValue2}}",
"{{customKey3}}": "{{customValue3}}"
}
}',
CURLOPT_HTTPHEADER => array(
'Authorization: Bearer {{BEARER_TOKEN}}',
'Content-Type: application/json'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
- lang: Java
source: |-
import java.net.HttpURLConnection;
import java.net.URL;
import java.io.OutputStream;
import java.io.InputStreamReader;
import java.io.BufferedReader;
public class Main {
public static void main(String[] args) {
try {
URL url = new URL('https://app.minimo.it/api/transactionals');
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod('POST');
conn.setRequestProperty('Authorization', 'Bearer {{BEARER_TOKEN}}');
conn.setRequestProperty('Content-Type', 'application/json');
conn.setDoOutput(true);
String jsonInputString = '{"recipient": "{{recipient}}", "uid": "{{uid}}", "customFields": {"{{customKey1}}": "{{customValue1}}", "{{customKey2}}": "{{customValue2}}", "{{customKey3}}": "{{customValue3}}"}}';
try(OutputStream os = conn.getOutputStream()) {
byte[] input = jsonInputString.getBytes('utf-8');
os.write(input, 0, input.length);
}
try(BufferedReader br = new BufferedReader(new InputStreamReader(conn.getInputStream(), 'utf-8'))) {
StringBuilder response = new StringBuilder();
String responseLine = null;
while ((responseLine = br.readLine()) != null) {
response.append(responseLine.trim());
}
System.out.println(response.toString());
}
} catch (Exception e) {
e.printStackTrace();
}
}
}
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: mn-API_CLIENT_ID-API_KEY
````