# Bestätigungen

> Kampagnenversand, das Ein- und Ausschalten von Automationen, Archivieren, Löschen, Erstattungen, Kündigungen und das Deaktivieren von Kund:innen passieren über die Tentary API erst, wenn die Kontoinhaberin oder der Kontoinhaber in Tentary bestätigt.

Source: https://tentary.com/de/help/api/confirmations/
Last updated: 2026-10-28

---

Manche Aktionen ändern über die API nichts sofort. Sie warten, bis die Kontoinhaberin oder der Kontoinhaber sie in Tentary bestätigt.

## Welche Aktionen eine Bestätigung brauchen

- [E-Mail-Kampagne versenden oder einplanen](https://tentary.com/de/help/api/send-email-campaign/)
- [E-Mail-Automation aktivieren oder deaktivieren](https://tentary.com/de/help/api/set-email-automation-status/)
- [E-Mail einer Automation aktivieren oder deaktivieren](https://tentary.com/de/help/api/set-automation-email-status/)
- [Löschen oder archivieren](https://tentary.com/de/help/api/delete-item/)
- [Bestellung erstatten](https://tentary.com/de/help/api/refund-order/)
- [Abo oder Ratenzahlung beenden](https://tentary.com/de/help/api/cancel-subscription/)
- [Externe Kund:innen deaktivieren](https://tentary.com/de/help/api/pause-customer/)

## Ablauf

1. Du rufst den Endpunkt auf, zum Beispiel `POST /v1/email/campaigns/{campaign_id}/send`. Dabei passiert noch nichts.
2. Die Antwort enthält eine `confirm_url` und eine `confirmation_id`.
3. Die Kontoinhaberin oder der Kontoinhaber öffnet die `confirm_url`, während sie oder er in Tentary angemeldet ist, und klickt auf **Bestätigen**. Mit **Nicht ausführen** wird die Aktion abgelehnt.
4. Mit [`GET /v1/confirmations/{confirmation_id}`](https://tentary.com/de/help/api/get-confirmation/) fragst du den Stand ab.

Die Seite in Tentary heißt **KI-Aktion bestätigen**. Sie zeigt, wer fragt, was passieren wird, und einen Link zum Objekt in Tentary.

## Status einer Bestätigung

| `status` | Bedeutung |
| --- | --- |
| `pending` | Noch nicht entschieden. |
| `running` | Bestätigt, die Aktion läuft gerade. Frag in ein paar Sekunden noch einmal. |
| `done` | Die Aktion ist gelaufen. `result` enthält die Details. |
| `failed` | Die Aktion konnte nicht laufen. `result` sagt, warum. |
| `canceled` | Die Aktion wurde abgelehnt. |
| `expired` | Der Link ist abgelaufen. |

## Regeln

- Der Link gilt 5 Minuten.
- Nur die Kontoinhaberin oder der Kontoinhaber desselben Kontos kann bestätigen.
- Eine Aktion läuft nur einmal.
- Hat sich das Objekt nach der Anfrage geändert, zum Beispiel der Text einer Kampagne, führt Tentary die Aktion nicht aus. Stell die Anfrage dann neu.
- Pro Konto gibt es höchstens 50 Anfragen für Bestätigungen pro Tag.

Eine bestätigte Aktion erscheint im [Aktivitätsprotokoll](https://app.tentary.com/settings/activity) mit dem Schlüssel oder der App, die gefragt hat.