Kontakte

Kontakte erreichen

Die Seite Contacts

Welche Daten ein Kontakt enthält

Kontakteigenschaften

• Der Schlüssel ist der Name, unter dem Sie den Wert referenzieren, zum Beispiel plan_tier. Er muss kleingeschrieben sein und mit einem Buchstaben beginnen (^[a-z][a-z0-9_]*$). Nach dem Erstellen lässt er sich nicht mehr ändern.
• Der Typ ist string, number, boolean oder datetime und lässt sich nach dem Erstellen ebenfalls nicht ändern. Ein Wert vom Typ datetime akzeptiert einen RFC-3339-Zeitstempel mit explizitem Offset, etwa 2026-01-15T11:30:00+02:00. Wir normalisieren ihn sekundengenau auf UTC, sodass dieser Wert als 2026-01-15T09:30:00Z gespeichert und zurückgegeben wird. Ein Datum ohne Uhrzeit wird abgelehnt. Das Dashboard bezeichnet diese Typen als Text, Number, True / false und Date & time.
• Der Ersatzwert wird für einen Kontakt ohne eigenen Wert gelesen. Ein fehlender Wert für plan_tier kann so als free statt als leeres Feld erscheinen.

Kontakte importieren und synchronisieren

const contact = await bird.contacts.create({
  email: "jane@acme.com",
  first_name: "Jane",
});
console.log(contact.id); // "con_…"

contact = client.contacts.create(email="jane@acme.com", first_name="Jane")
print(contact.id, contact.email)

contact, err := client.Contacts.Create(context.Background(), bird.ContactCreateParams{
	Email:     bird.Ptr("jane@acme.com"),
	FirstName: bird.Ptr("Jane"),
})
if err != nil {
	log.Fatal(err)
}
fmt.Println(contact.Id)

$contact = $bird->contacts->create(
    (new ContactCreateRequest())
        ->setEmail('jane@acme.com')
        ->setFirstName('Jane'),
);
echo $contact->getId(); // "con_…"

bird contacts create alice@acme.com \
  --first-name Alice \
  --last-name Anderson \
  --phone-number +31612345678

{
  "name": "contacts_create",
  "arguments": {
    "email": "alice@acme.com",
    "first_name": "Alice",
    "last_name": "Anderson",
    "phone_number": "+31612345678"
  }
}

curl -X POST "https://{region}.platform.bird.com/v1/contacts" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "alice@acme.com",
    "phone_number": "+31612345678",
    "first_name": "Alice",
    "last_name": "Anderson"
  }'

{
  "data": [
    {
      "contact_id": "con_01ky7q5t51echr7mqj5c08423b",
      "entry": { "email": "alex@example.com", "phone_number": null, "external_id": null },
      "matched_on": "email",
      "status": "updated"
    },
    {
      "contact_id": "con_01ky7q6mxdfhe86c9dqyt866pz",
      "entry": { "email": "jamie@example.com", "phone_number": null, "external_id": null },
      "matched_on": null,
      "status": "created"
    },
    {
      "contact_id": "con_01ky7q7rv9e9pt4vkr0w0gxq5e",
      "entry": { "email": "casey@example.com", "phone_number": null, "external_id": "user_2214" },
      "matched_on": "external_id",
      "status": "updated"
    }
  ]
}

Einen Kontakt löschen

Nächste Schritte

• Zielgruppen: Kontakte in wiederverwendbaren Listen zusammenfassen
• Unterdrückungen: die von Ihren Kontakten getrennte Liste der Adressen im Workspace, an die wir nicht zustellen
• Batch-Versand: viele Empfänger mit einem Aufruf erreichen, bis zu 100 Nachrichten pro Anfrage
• CLI: Kontakte, Eigenschaften und Zielgruppen mit dem Befehl bird per Skript verwalten
• API-Referenz: vollständige Anfrage- und Antwortschemas