E-Mails
Send e-mail campaign
/ v1 / email / campaigns / {campaign_id} / send Sends a draft campaign to its audience now, or schedules it with send_at.
The campaign needs a subject, a text, safe links and, for a product audience, products. GET /v1/email/campaigns/{campaign_id} shows problems_before_sending. Send a test with POST /v1/email/test first.
After the call: the account owner confirms at the confirm_url within 5 minutes. Then check the result with GET /v1/confirmations/{confirmation_id}.
The confirmation page shows the estimated number of recipients. After the send, GET /v1/confirmations/{confirmation_id} returns it.
Ändert nichts sofort. Die Antwort enthält einen Link, den die Kontoinhaberin oder der Kontoinhaber in Tentary bestätigt. Bestätigungen
Autorisierung
-
Authorizationstring Header erforderlichBearer tnt_…· A personal API key (tnt_...). Create it in the Tentary app on the page AI & API. Einführung
Pfad-Parameter
-
campaign_idinteger erforderlichA draft from list_email_campaigns or create_email_campaign.
min.
1Beispiel:802
Body application/json
-
send_atstringTime with a zone, like 2026-11-26T09:00:00Z. Leave out to send at once after the confirmation.
Antwort
Felder der Antwort mit Status 200. Fehler haben immer dasselbe Format, siehe Fehler.
The action waits for the seller's confirmation.
-
statusstringNothing happened yet.
Mögliche Werte:
needs_confirmation -
confirmation_idintegerFor get_confirmation.
-
confirm_urlstring<uri>The seller opens it while logged in to Tentary and confirms.
-
expires_atstring<date-time>UTC, like 2026-01-31T14:05:00Z. The link works until then.
-
summarystringWhat the seller confirms.
-
messagestringNext steps for the AI app.