# Kunden anlegen

> Für KI-Agenten: Das vollständige Verzeichnis der Dokumentation steht unter [llms.txt](https://stampywallet.com/de/docs/llms.txt), die gesamte Dokumentation passt in eine Datei: [llms-full.txt](https://stampywallet.com/de/docs/llms-full.txt). Seite online: https://stampywallet.com/de/docs/api/kunden-anlegen/

POST /v1/clients meldet einen Kunden im Treueprogramm an und liefert den Link zu seiner Karte, den Sie ihm per SMS oder E-Mail schicken.

`POST /v1/clients`

Meldet einen Kunden an, als hätte er den Aufsteller gescannt, und liefert das Kundenobjekt mit `lien_carte`: die Seite, auf der er seine Karte zu Apple Wallet oder Google Wallet hinzufügt. Die Willkommensstempel des Geschäfts werden vergeben, wie bei der Anmeldung.

**Body (JSON)**

- `prenom` (string, optional) : Vorname des Kunden, auf seiner Karte angezeigt.
- `nom` (string, optional) : Nachname.
- `telephone` (string, optional) : Eine Mobilnummer, im Format des Landes des Geschäfts oder international (`+33612345678`). Sonst `400 telephone_invalide`.
- `email` (string, optional) : E-Mail-Adresse.
- `conditions_acceptees` (boolean, optional) : Pflicht (`true`), wenn das Geschäft die Zustimmung zu seinen Bedingungen verlangt (`conditions_exigees` aus [`GET /v1/commerce`](https://stampywallet.com/de/docs/api/geschaeft/)); sonst `422 conditions_requises`.

> **Achtung :** diese Route **prüft nicht auf Dubletten**: Zweimal aufgerufen, legt sie zwei Kunden an. Suchen Sie zuerst mit [`GET /v1/clients`](https://stampywallet.com/de/docs/api/kunden-finden/), oder gehen Sie direkt über [`POST /v1/passages`](https://stampywallet.com/de/docs/api/besuch-erfassen/) mit `creer_si_absent: true`, das den Kunden nur anlegt, wenn es ihn noch nicht gibt.

Ein über die API angelegter Kunde wird nie für Angebots-SMS angemeldet: Er wurde darüber nicht informiert.

## Beispiel

```bash title="curl"
curl https://app.stampywallet.com/v1/clients \
  -H "Authorization: Bearer sw_live_votre_cle" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: inscription-0412" \
  -d '{"prenom": "Léa", "telephone": "+33612345678"}'
```
```js title="Node.js"
const r = await fetch('https://app.stampywallet.com/v1/clients', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.STAMPY_CLE}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': 'inscription-0412',
  },
  body: JSON.stringify({ prenom: 'Léa', telephone: '+33612345678' }),
});
const client = await r.json();
console.log(client.lien_carte);
```
```python title="Python"
import os, requests

r = requests.post(
    "https://app.stampywallet.com/v1/clients",
    headers={"Authorization": f"Bearer {os.environ['STAMPY_CLE']}",
             "Idempotency-Key": "inscription-0412"},
    json={"prenom": "Léa", "telephone": "+33612345678"},
)
lien = r.json()["lien_carte"]
```

## Antwort

`201 Created` und [das Kundenobjekt](https://stampywallet.com/de/docs/api/kunden-abrufen/#objet), zum Beispiel:

```json title="201 Created"
{
  "id": "c2a91f3e-7d40-4b8a-a3c5-91e0d6f4b2c7",
  "prenom": "Léa",
  "nom": null,
  "telephone": "+33612345678",
  "email": null,
  "carte": "X7k2pQ9mLw",
  "lien_carte": "https://stampywallet.com/c/X7k2pQ9mLw",
  "cree_le": "2026-10-25T10:41:52.120Z",
  "etat": { "mode": "tampons", "tampons": 1, "points": null, "objectif": 10, "restants": 9,
            "prochaine_recompense": { "seuil": 10, "libelle": "Ein Baguette gratis" },
            "recompenses_disponibles": [], "recompenses_obtenues": 0,
            "dernier_passage": null, "premium": null }
}
```

> **Hinweis :** schicken Sie `lien_carte` über einen Kanal Ihrer Wahl an den Kunden: StampyWallet schreibt ihm in diesem Schritt nicht.
