---
title: Démarrage rapide
description: Créez un compte, vérifiez un domaine, générez une clé d'API et envoyez votre premier e-mail avec curl ou le SDK Node.js, puis testez avec le simulateur SES.
seo:
  title: "Démarrage rapide : envoyez un e-mail"
ai:
  exclude: true
---

## 1. Inscription

Créez un compte sur [billionsend.com](https://billionsend.com). Le tableau de bord s'y trouve ; l'API est à l'adresse `https://api.billionsend.com`.

## 2. Vérifier un domaine

Vous ne pouvez envoyer que depuis des domaines que vous avez vérifiés.

1. Ouvrez **Domaines** et ajoutez un domaine qui vous appartient, par exemple `acme.dev`.
2. Ajoutez chez votre fournisseur DNS les enregistrements affichés (DKIM et MAIL FROM).
3. Cliquez sur **Vérifier un domaine**. La page indique quels enregistrements manquent encore.

Consultez [Domaines](/docs/fr/concepts/domains).

## 3. Créer une clé d'API

Ouvrez **Clés API** et créez-en une. La clé `bs_` n'est affichée qu'une seule fois, alors copiez-la. Une clé peut donner un accès complet ou servir uniquement à l'envoi, et peut être limitée à un domaine.

## 4. Envoyer un e-mail

Avec 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>"
  }'
```

Ou avec le SDK Node.js (`npm install @billionsend/node`) :

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

const bs = new BillionSend("bs_..."); // ou new BillionSend() avec BILLIONSEND_API_KEY défini

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);
```

Les deux renvoient `{ "id": "..." }`. Regardez l'e-mail passer de `queued` à `delivered` sur la page **E-mails**. Autres langages : consultez [SDK](/docs/fr/sdks).

## Tests

- `success@simulator.amazonses.com` simule une distribution sans envoyer d'e-mail à personne. Ajoutez une étiquette pour varier : `success+signup@simulator.amazonses.com`.
- Les e-mails envoyés au simulateur comptent quand même dans le quota de votre forfait.
- `bounce@`, `complaint@` et `suppressionlist@` sur le simulateur produisent de vrais rebonds et de vraies plaintes : l'adresse est ajoutée à votre [liste de suppression](/docs/fr/concepts/suppressions) et l'événement déclenche vos webhooks, mais les retours du simulateur ne comptent jamais dans vos taux de rebond et de plainte. Utilisez-les à la main, pas dans des tests automatisés. Chaque adresse ne fonctionne qu'une fois ; ajoutez donc une étiquette pour en obtenir une nouvelle : `bounce+2@simulator.amazonses.com`.
- Les adresses en `example.com`, ou se terminant par `.test` ou `.invalid`, ne peuvent pas recevoir d'e-mails. Un envoi vers l'une d'elles est refusé avec `422` (consultez [Notions de base de l'API](/docs/fr/api-reference/basics)).

## Étapes suivantes

- [E-mails](/docs/fr/concepts/emails), [Contacts](/docs/fr/concepts/contacts) et [Campagnes](/docs/fr/concepts/broadcasts).
- [SDK](/docs/fr/sdks) pour votre langage.
- [Référence de l'API](/docs/fr/api-reference) pour chaque point de terminaison.
