# sevDesk: remind overdue invoices by SMS automatically

> Remind customers of overdue sevDesk invoices by SMS, automatically: API token, reminder days, text templates and a preview, before the formal dunning letter.

Published: 2026-11-15 · 6 min read · Web version: https://topsms.eu/blog/sevdesk-overdue-invoice-sms · Deutsch: https://topsms.eu/de/blog/sevdesk-mahnung-sms.md

## In short

Copy the API token of a sevDesk administrator, paste it in the TopSMS dashboard under Invoice reminders and set the days after the due date (default 3, 10, 21). TopSMS reads open and partially paid invoices every hour within your send window, calculates the due date from the invoice date and payment term, and texts the customer’s mobile number. It runs alongside sevDesk’s own dunning letters; each SMS costs €0.089 to Germany and Austria.

sevDesk can create dunning letters for unpaid invoices. A dunning letter is formal, though, and it usually goes out by e-mail, where it competes with everything else in the inbox. A short SMS a few days after the due date is a lighter first step. This guide shows how to send it automatically for every overdue sevDesk invoice, with no automation tool in between.

## What the integration reads from sevDesk

TopSMS uses the sevDesk API with an administrator’s API token. According to the sevDesk documentation, every administrator has one token, a 32-character hexadecimal string that is sent in the `Authorization` header and does not expire as long as the user exists. Every hour TopSMS reads:

- **Invoices** with the status open (200) or partially paid (750), including the contact.
- **The due date:** sevDesk stores the invoice date and a payment term in days (`timeToPay`). TopSMS adds the two; an invoice dated 1 March with 14 days to pay is due on 15 March.
- **The open amount:** gross total minus the amount paid. A part payment therefore lowers the amount in the next SMS.
- **The phone number** from the contact’s communication entries.

Normal invoices, partial invoices, advance invoices and final invoices are included. Recurring invoice templates, cancellation invoices and dunning documents (type MA) are not reminded, so a customer never gets one SMS for the invoice and another for the dunning letter. The integration only reads; nothing is written back to sevDesk.

## Step 1: copy the API token

In sevDesk open **Settings, Users** and copy the API token of an administrator. sevDesk shows the token there and lets you generate a new one, which invalidates the old one. TopSMS stores the token encrypted and checks straight away that it may read invoices.

## Step 2: connect sevDesk in TopSMS

In the TopSMS dashboard open **Invoice reminders**, choose sevDesk under Germany, paste the token and save. Then set the reminder days. The default `3, 10, 21` means three SMS at most: three, ten and 21 days after the due date. You can enter up to five days between 0 and 365. An invoice that is already further along when you start gets only the latest stage it has reached, never a pile of catch-up messages.

## Step 3: write the text

The default German text names the invoice, the open amount, the days overdue and the due date, and fits in one SMS with typical values. You can replace it. Two alternatives that work well as a first and a last stage, in German for German customers:

```
{my}: Rechnung {number} über {amount} war am {due_date} fällig. Schon bezahlt? Dann ignorieren Sie diese SMS. Fragen: 030 1234567
```

```
{my}: Rechnung {number} ist seit {days} Tagen überfällig, offen sind {amount}. Bitte überweisen Sie den Betrag bis Ende der Woche.
```

And an English one:

```
{my}: reminder, invoice {number} for {amount} was due on {due_date}. Already paid? Then please ignore this SMS. Questions: 030 1234567
```

The text must contain `{number}`. Other variables: `{amount}`, `{amount_total}`, `{due_date}`, `{days}`, `{customer}` and `{my}`. One text applies to all stages, so word it to fit both the first and the last reminder, or use `{days}` to make the urgency visible. The dashboard shows a sample with the character count; keep it within 160 characters for one SMS. With “GSM-7 characters only”, which is on by default, umlauts and ß stay, and typographic quotes and dashes are replaced so the message does not switch to the 70-character Unicode mode.

## Step 4: check the preview

**Preview overdue invoices** lists each overdue invoice with the decision: send, with the exact text and number of SMS parts, or skip, with the reason. Typical reasons are a missing phone number, a landline, an amount below your minimum, a reminder already sent, a reminder in the last three days, or a first stage not reached yet. The preview sends and charges nothing. Missing mobile numbers are the most common gap; add them in the sevDesk contact as a mobile entry, then run the preview again.

## Built-in limits

| Rule | Value |
| --- | --- |
| Send window | 9:00 to 17:00 CET by default, adjustable |
| Weekends | no SMS by default (“Weekdays only”) |
| Minimum amount | optional, in EUR |
| Per invoice | one SMS per stage, at least 3 days between two SMS |
| Paid | open amount of 50 cents or less: no SMS |
| Length | texts longer than 3 SMS parts are not sent |
| Errors | after 3 failed SMS in a row the run stops |

## Sender name

Without a choice, reminders come from “TopSMS”. Pick your own approved sender name in the settings; customers recognise it and the reminder looks less like spam. A name cannot receive replies, so add a phone number, as in the templates above.

## Costs

The integration has no monthly fee. You pay €0.089 per SMS to Germany, Austria and the rest of the EU, a final price with no VAT added, from prepaid credit that never expires. 50 overdue invoices with up to three stages each mean at most 150 SMS, or €13.33; in practice fewer, because paid invoices drop out. New accounts get €0.50 free credit after phone verification, about 5 SMS to Germany. See the [pricing page](https://topsms.eu/pricing) for other countries.

> A reminder about an unpaid invoice is a service message, not marketing. Keep it factual and free of offers. If you work with lexoffice instead, read [automatic SMS payment reminders from lexoffice](https://topsms.eu/blog/sms-payment-reminders-lexoffice).

[Create a free account](https://topsms.eu/#register), connect sevDesk and check the preview before the first SMS goes out.

## Frequently asked questions

### Does this replace the dunning function in sevDesk?

No. sevDesk’s dunning documents stay as they are; TopSMS ignores them and reminds by the original invoice. Many businesses send an SMS first and the formal dunning letter later.

### Which invoices are reminded?

Invoices with the status open or partially paid whose due date (invoice date plus payment term) has passed: normal, partial, advance and final invoices. Drafts, paid invoices, cancellations, recurring templates and dunning documents are skipped.

### Which phone number is used?

The contact’s communication entries of type mobile come first, the main entry before others; a regular phone entry is used only when no mobile entry works. A number without a country code is read as German (+49). German landlines are skipped.

### What if the API token changes?

If you generate a new token in sevDesk, the old one stops working and the dashboard shows an error at the next run. Paste the new token and save.

## Related pages

- [Invoice payment reminders: overview](https://topsms.eu/use-cases/invoice-payment-reminders)
- [The same for lexoffice](https://topsms.eu/blog/sms-payment-reminders-lexoffice)
- [Pricing per SMS](https://topsms.eu/pricing)
- [How many characters fit in an SMS?](https://topsms.eu/blog/sms-length-characters)

## Sources

- [sevdesk API documentation: authentication with the administrator API token, invoice status and invoice types](https://api.sevdesk.de/) (checked 2026-11-15)
- [sevdesk API: OpenAPI specification (Invoice, timeToPay, CommunicationWay)](https://api.sevdesk.de/openapi.yaml) (checked 2026-11-15)
