---
title: Quickstart
description: Konto anlegen, Domain verifizieren, API-Schlüssel erstellen und die erste E-Mail per curl oder Node.js-SDK senden, dann mit dem SES-Mailbox-Simulator testen.
seo:
  title: "Quickstart: Ihre erste E-Mail senden"
ai:
  exclude: true
---

## 1. Registrieren

Legen Sie auf [billionsend.com](https://billionsend.com) ein Konto an. Dort finden Sie das Dashboard; die API liegt unter `https://api.billionsend.com`.

## 2. Domain verifizieren

Sie können nur von Domains senden, die Sie verifiziert haben.

1. Öffnen Sie **Domains** und fügen Sie eine Domain hinzu, die Ihnen gehört, zum Beispiel `acme.dev`.
2. Tragen Sie die angezeigten DNS-Einträge (DKIM und MAIL FROM) bei Ihrem DNS-Anbieter ein.
3. Klicken Sie auf **Domain verifizieren**. Die Seite zeigt, welche Einträge noch fehlen.

Siehe [Domains](/docs/de/concepts/domains).

## 3. API-Schlüssel erstellen

Öffnen Sie **API-Schlüssel** und erstellen Sie einen. Der `bs_`-Schlüssel wird nur einmal angezeigt, kopieren Sie ihn also. Ein Schlüssel kann vollen Zugriff haben oder nur zum Senden dienen und lässt sich auf eine Domain beschränken.

## 4. E-Mail senden

Mit curl:

```sh
curl -X POST https://api.billionsend.com/emails \
  -H "Authorization: Bearer bs_..." \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Acme <onboarding@acme.dev>",
    "to": ["success@simulator.amazonses.com"],
    "subject": "Hello from BillionSend",
    "html": "<strong>It works!</strong>"
  }'
```

Oder mit dem Node.js-SDK (`npm install @billionsend/node`):

```ts
import { BillionSend } from "@billionsend/node";

const bs = new BillionSend("bs_..."); // or new BillionSend() with BILLIONSEND_API_KEY set

const { data, error } = await bs.emails.send({
  from: "Acme <onboarding@acme.dev>",
  to: ["success@simulator.amazonses.com"],
  subject: "Hello from BillionSend",
  html: "<strong>It works!</strong>",
});

if (error) console.error(error.name, error.message);
else console.log("sent", data.id);
```

Beide geben `{ "id": "..." }` zurück. Auf der Seite **E-Mails** sehen Sie, wie die E-Mail von `queued` zu `delivered` wechselt. Andere Sprachen: siehe [SDKs](/docs/de/sdks).

## Testen

- `success@simulator.amazonses.com` simuliert eine Zustellung, ohne dass jemand eine E-Mail erhält. Mit einem Label bleiben die Adressen unterscheidbar: `success+signup@simulator.amazonses.com`.
- E-Mails an den Simulator zählen trotzdem auf das Kontingent Ihres Tarifs.
- `bounce@`, `complaint@` und `suppressionlist@` beim Simulator erzeugen echte Bounces und Beschwerden: Die Adresse landet auf Ihrer [Sperrliste](/docs/de/concepts/suppressions) und das Event löst Ihre Webhooks aus, doch Simulator-Rückmeldungen zählen nie in Ihre Bounce- und Beschwerderaten. Nutzen Sie sie von Hand, nicht in automatisierten Tests. Jede Adresse funktioniert nur einmal, für eine frische Adresse ergänzen Sie ein Label: `bounce+2@simulator.amazonses.com`.
- Adressen bei `example.com` oder unter `.test` und `.invalid` können keine E-Mails empfangen. Ein Versand an eine solche Adresse wird mit `422` abgelehnt (siehe [API-Grundlagen](/docs/de/api-reference/basics)).

## Nächste Schritte

- [E-Mails](/docs/de/concepts/emails), [Kontakte](/docs/de/concepts/contacts) und [Newsletter-Versand](/docs/de/concepts/broadcasts).
- [SDKs](/docs/de/sdks) für Ihre Sprache.
- [API-Referenz](/docs/de/api-reference) für jeden Endpunkt.
