Document Emails

Send document email

Sends a supported public document by email.

Supported document types

The endpoint supports invoice, proforma, order, credit-note, and quotation.

Business behavior

The target document is resolved via documentType + documentId and must be available in the token scope.
The to field accepts an array of one or more email addresses.
The type field is required for a uniform contract. For invoice and proforma, it changes the subject and mail type (regular, reminder, overdue_reminder, confirmation). For order, credit-note, and quotation, it currently behaves the same as a regular send.
The endpoint does not return a response body; success is indicated by 202 Accepted.

If you send an Idempotency-Key, the same key with the same payload returns the original response without sending the email again.

POST

document-mails

Send document email

curl --request POST \
  --url https://app.fintoro.sk/api/public/v1/document-mails \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "documentType": "invoice",
  "documentId": 301,
  "to": [
    "billing@example.test",
    "owner@example.test"
  ],
  "type": "reminder",
  "body": "Please find document {{document_number}} attached, totalling {{total}}."
}
'

import requests

url = "https://app.fintoro.sk/api/public/v1/document-mails"

payload = {
    "documentType": "invoice",
    "documentId": 301,
    "to": ["billing@example.test", "owner@example.test"],
    "type": "reminder",
    "body": "Please find document {{document_number}} attached, totalling {{total}}."
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    documentType: 'invoice',
    documentId: 301,
    to: ['billing@example.test', 'owner@example.test'],
    type: 'reminder',
    body: JSON.stringify('Please find document {{document_number}} attached, totalling {{total}}.')
  })
};

fetch('https://app.fintoro.sk/api/public/v1/document-mails', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.fintoro.sk/api/public/v1/document-mails",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'documentType' => 'invoice',
    'documentId' => 301,
    'to' => [
        'billing@example.test',
        'owner@example.test'
    ],
    'type' => 'reminder',
    'body' => 'Please find document {{document_number}} attached, totalling {{total}}.'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.fintoro.sk/api/public/v1/document-mails"

	payload := strings.NewReader("{\n  \"documentType\": \"invoice\",\n  \"documentId\": 301,\n  \"to\": [\n    \"billing@example.test\",\n    \"owner@example.test\"\n  ],\n  \"type\": \"reminder\",\n  \"body\": \"Please find document {{document_number}} attached, totalling {{total}}.\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.fintoro.sk/api/public/v1/document-mails")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"documentType\": \"invoice\",\n  \"documentId\": 301,\n  \"to\": [\n    \"billing@example.test\",\n    \"owner@example.test\"\n  ],\n  \"type\": \"reminder\",\n  \"body\": \"Please find document {{document_number}} attached, totalling {{total}}.\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.fintoro.sk/api/public/v1/document-mails")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"documentType\": \"invoice\",\n  \"documentId\": 301,\n  \"to\": [\n    \"billing@example.test\",\n    \"owner@example.test\"\n  ],\n  \"type\": \"reminder\",\n  \"body\": \"Please find document {{document_number}} attached, totalling {{total}}.\"\n}"

response = http.request(request)
puts response.read_body

{
  "message": "Unauthenticated."
}

{
  "message": "This action is unauthorized."
}

{
  "message": "The given data was invalid.",
  "error": "Idempotency-Key reused with different request payload",
  "errors": {}
}

{
  "message": "Too Many Attempts."
}

{
  "message": "Server Error"
}

{
  "message": "Service Unavailable"
}

Authorizations

Authorization

string

header

required

Bearer token created for a specific company in Integrations → API.

Headers

Idempotency-Key

string

Optional request identifier for safe retries. Use a unique value for each create request you want to retry safely.

Example:

"invoice-create-2026-03-03-001"

Body

application/json

Payload used to send a supported document by email. The target document is selected through documentType + documentId and must be available in the token scope.

documentType

enum<string>

required

Document type you want to send by email.

Available options:

invoice,

proforma,

order,

credit-note,

quotation

Example:

"invoice"

documentId

integer

required

ID of a supported document.

Example:

301

string<email>[]

required

Array of one or more target email addresses.

Minimum array length: 1

Example:

[
  "billing@example.test",
  "owner@example.test"
]

type

enum<string>

required

Mail type. For invoice and proforma, it changes the subject and template type; for order, credit-note, and quotation, it currently behaves the same as regular.

Available options:

regular,

reminder,

overdue_reminder,

confirmation

Example:

"reminder"

body

string | null

Optional custom text inserted into the email body. Supports {{document_number}} (document number), {{customer_name}} (customer), {{company_name}} (issuer), {{issue_date}} (issue date), {{due_date}} (due date), {{total}} (total including VAT), {{amount_due}} (remaining amount due), {{variable_symbol}} (variable symbol), {{iban}} (document bank account IBAN), {{total_without_vat}} (total excluding VAT), {{delivery_date}} (delivery date), {{constant_symbol}} (constant symbol), and {{specific_symbol}} (specific symbol). Delivery date is available for invoices and credit notes; payment symbols for invoices, proformas, and credit notes. Tags are replaced with the document's data before the email is persisted and queued for delivery. Dates follow the document's language; amounts follow its language and currency, with two decimal places. Data unavailable for the document is replaced with an empty string. Unknown tags remain unchanged. Omitting this field or passing null does not automatically use the saved template from settings. Input text must not contain URLs and is limited to 1000 characters before tag replacement.

Maximum string length: 1000

Example:

"Please find document {{document_number}} attached, totalling {{total}}."

Response

Document send request accepted.

Send document email

curl --request POST \
  --url https://app.fintoro.sk/api/public/v1/document-mails \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "documentType": "invoice",
  "documentId": 301,
  "to": [
    "billing@example.test",
    "owner@example.test"
  ],
  "type": "reminder",
  "body": "Please find document {{document_number}} attached, totalling {{total}}."
}
'

import requests

url = "https://app.fintoro.sk/api/public/v1/document-mails"

payload = {
    "documentType": "invoice",
    "documentId": 301,
    "to": ["billing@example.test", "owner@example.test"],
    "type": "reminder",
    "body": "Please find document {{document_number}} attached, totalling {{total}}."
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    documentType: 'invoice',
    documentId: 301,
    to: ['billing@example.test', 'owner@example.test'],
    type: 'reminder',
    body: JSON.stringify('Please find document {{document_number}} attached, totalling {{total}}.')
  })
};

fetch('https://app.fintoro.sk/api/public/v1/document-mails', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.fintoro.sk/api/public/v1/document-mails",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'documentType' => 'invoice',
    'documentId' => 301,
    'to' => [
        'billing@example.test',
        'owner@example.test'
    ],
    'type' => 'reminder',
    'body' => 'Please find document {{document_number}} attached, totalling {{total}}.'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.fintoro.sk/api/public/v1/document-mails"

	payload := strings.NewReader("{\n  \"documentType\": \"invoice\",\n  \"documentId\": 301,\n  \"to\": [\n    \"billing@example.test\",\n    \"owner@example.test\"\n  ],\n  \"type\": \"reminder\",\n  \"body\": \"Please find document {{document_number}} attached, totalling {{total}}.\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.fintoro.sk/api/public/v1/document-mails")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"documentType\": \"invoice\",\n  \"documentId\": 301,\n  \"to\": [\n    \"billing@example.test\",\n    \"owner@example.test\"\n  ],\n  \"type\": \"reminder\",\n  \"body\": \"Please find document {{document_number}} attached, totalling {{total}}.\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.fintoro.sk/api/public/v1/document-mails")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"documentType\": \"invoice\",\n  \"documentId\": 301,\n  \"to\": [\n    \"billing@example.test\",\n    \"owner@example.test\"\n  ],\n  \"type\": \"reminder\",\n  \"body\": \"Please find document {{document_number}} attached, totalling {{total}}.\"\n}"

response = http.request(request)
puts response.read_body

{
  "message": "Unauthenticated."
}

{
  "message": "This action is unauthorized."
}

{
  "message": "The given data was invalid.",
  "error": "Idempotency-Key reused with different request payload",
  "errors": {}
}

{
  "message": "Too Many Attempts."
}

{
  "message": "Server Error"
}

{
  "message": "Service Unavailable"
}

Overview

Endpoints

Send document email

Supported document types

Business behavior

Authorizations

Headers

Body

Response