Zum Inhalt springen
adaptmailAPI
Deutsch

Schicken Sie einen E-Mail

API 0.16.0OpenAPIllms-full.txt
POST/v1/mailboxes/{mailbox_id}/send

Erforderlich Idempotency-Key 8–128 Zeichen lang. Das Wiederholen mit demselben Schlüssel und Körper führt zum gleichen Vorgang. Ein anderer Körper gibt 409. HTTP 202 bedeutet Warteschlange. Überprüfen Sie den Status des Vorgangs, nicht die Tatsache, dass eine Antwort eingegangen ist.

Berechtigungs- und Zugangsbereiche · Fehler und Wiederholungen

Anfrage

Terminal-Fenster
curl -X POST 'https://adapt-mail.com/v1/mailboxes/<mailbox_id>/send' \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Idempotency-Key: message-20261019-0001' \
  -H 'Content-Type: application/json' \
  --data '{"to":["[email protected]"],"subject":"Hello","text":"A message from Adapt Mail"}'

Optionen

mailbox_idpathUnbedingt

integer

X-Customer-IDheader
Option 1

string

Option 2

null

Idempotency-KeyheaderUnbedingt

string

minLength: 8

maxLength: 128

Anforderungstext · application/json

object

toUnbedingt

array

Adressen der Hauptempfänger.

minItems: 1

maxItems: 50

Array-Elemente

string

cc

array

Kopieren Sie Empfängeradressen, die für andere Teilnehmer sichtbar sind.

maxItems: 50

Array-Elemente

string

bcc

array

Bcc-Empfängeradressen.

maxItems: 50

Array-Elemente

string

subject

string

Betreff des Briefes.

Standard: ""

maxLength: 998

text

string

Der Text des Briefes ohne Formatierung.

Standard: ""

maxLength: 200000

html

HTML-formatierte Version des Briefes.

Option 1

string

maxLength: 300000

Option 2

null

file_ids

array

ID zuvor heruntergeladene Dateien in diesem Postfach. Erhalten Sie sie beim Herunterladen oder aus der Dateiliste.

maxItems: 20

Array-Elemente

string · uuid

forward_message

Die ursprüngliche E-Mail, deren Anhänge weitergeleitet werden müssen.

Option 1

object

folderUnbedingt

string

Ordnername aus der Ordnerliste, zum Beispiel INBOX.

minLength: 1

maxLength: 255

uidvalidityUnbedingt

integer

Der Wert ist uidvalidity aus der Antwort API für diesen Ordner.

exclusiveMinimum: 0

uidUnbedingt

integer

exclusiveMinimum: 0

Unbekannte Felder werden nicht akzeptiert.

Option 2

null

reply_to_message_id

Der message_id-Wert der E-Mail, auf die Sie antworten.

Option 1

string

maxLength: 998

Option 2

null

references

Der Wert references der Originalnachricht zum Speichern der Antwortkette.

Option 1

string

maxLength: 4000

Option 2

null

send_at

Verzögerte Versandzeit mit Zeitzone, zum Beispiel 2026-11-01T12:00:00Z. Ohne einen Wert beginnt der Versand, während die Warteschlange verarbeitet wird.

Option 1

string · date-time

Option 2

null

Unbekannte Felder werden nicht akzeptiert.

Antworten

202 Erfolgreiche Antwort

application/json

object

id

string · uuid

Vorgangs-ID zum Überprüfen des Status und Abbrechen einer ausstehenden Übermittlung.

kind

string

mailbox_id
Option 1

integer

Option 2

null

status

string

Gültige Werte: "queued" "running" "succeeded" "failed" "uncertain" "cancelled"

run_at

string

Datum und Uhrzeit in UTC. Wenn kein Offset vorhanden ist, stellt der Wert auch UTC. dar

created_at

string

Datum und Uhrzeit in UTC. Wenn kein Offset vorhanden ist, stellt der Wert auch UTC. dar

completed_at
Option 1

string

Datum und Uhrzeit in UTC. Wenn kein Offset vorhanden ist, stellt der Wert auch UTC. dar

Option 2

null

error

Der Grund für den Fehler, wenn der Vorgang nicht erfolgreich abgeschlossen wurde.

Option 1

string

Option 2

null

result

Das Ergebnis der Operation. Enthält zum Versenden Informationen über angenommene und abgelehnte Empfänger.

Option 1

object

Option 2

null

400 Ungültiger Header oder Bezeichner

application/json

object

detail
Option 1

string

Option 2

object

code

string

message

string

Option 3

array

Array-Elemente

object

401 Anmeldung erforderlich

application/json

object

detail
Option 1

string

Option 2

object

code

string

message

string

Option 3

array

Array-Elemente

object

403 Kein Zugriff

application/json

object

detail
Option 1

string

Option 2

object

code

string

message

string

Option 3

array

Array-Elemente

object

404 Ressource nicht gefunden

application/json

object

detail
Option 1

string

Option 2

object

code

string

message

string

Option 3

array

Array-Elemente

object

409 Staatskonflikt

application/json

object

detail
Option 1

string

Option 2

object

code

string

message

string

Option 3

array

Array-Elemente

object

413 Größe überschritten

application/json

object

detail
Option 1

string

Option 2

object

code

string

message

string

Option 3

array

Array-Elemente

object

422 Validierungsfehler

application/json

object

detail

array

Array-Elemente

object

locUnbedingt

array

Array-Elemente
Option 1

string

Option 2

integer

msgUnbedingt

string

typeUnbedingt

string

503 Vorübergehende Nichtverfügbarkeit

application/json

object

detail
Option 1

string

Option 2

object

code

string

message

string

Option 3

array

Array-Elemente

object

Erfolgreiches Einreichungsergebnis

Die result-Felder des Vorgangs sind nach der Ausführung und nicht die Antwort auf die Warteschlange.

object

message_id

string

smtp_accepted

boolean

sent_saved

boolean

accepted_recipients

array

Array-Elemente

string

rejected_recipients

array

Array-Elemente

object

email

string

code

integer