Zum Inhalt springen

Kontakte

Die Menschen und Unternehmen, mit denen du arbeitest.

Kontakte öffnen
Am 20. November 2026 mit dem Dashboard abgeglichen

Contacts hat keinen eigenen Microservice. Seine öffentlichen Methoden gehören zum Account-Microservice, der auch Profile enthält, und für Freundschaftsanfragen zum Team-Microservice. Jede Methode handelt für das Konto, dessen API-Schlüssel du verwendest.

Gruppen, Tags, benutzerdefinierte Felder, In Kontakt bleiben, die Duplikatprüfung, der Import und die Wahl eines Tarifs haben heute keine öffentliche Methode. Das erledigst du im Dashboard.

Sende mit deinem Schlüssel eine Anfrage an eine Methode:

curl -s https://xuda.ai/cpi/create_contact \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","name":"Dana Levi","email":"[email protected]","company":"Levi Studio"}'
const res = await fetch('https://xuda.ai/cpi/create_contact', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',
    name: 'Dana Levi',
    email: '[email protected]',
    company: 'Levi Studio',
  }),
});
const { code, data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/create_contact',
    json={
        'api_key': 'YOUR_API_KEY',
        'name': 'Dana Levi',
        'email': '[email protected]',
        'company': 'Levi Studio',
    },
)

Eine abgelehnte Anfrage antwortet mit einem negativen code und nennt den Grund in data. Die meisten der folgenden Methoden akzeptieren außerdem ein optionales workspace_id, um in einem Workspace zu handeln, den du besitzt und der nicht dein Heim-Workspace ist.

Kontakte lesen

get_contacts listet die Kontakte auf.

  • _id oder contact_id liefert einen einzelnen Kontakt.
  • search filtert die Liste nach einem Suchbegriff und name nach einem Namen.
  • filter_type grenzt die Liste ein, zum Beispiel auf archived, shared, pinned, favorites oder online. Ohne Angabe werden die aktiven Kontakte zusammen mit den wartenden Verbindungsanfragen aufgelistet.
  • with_requests auf true gesetzt fügt auch einer gefilterten Liste die offenen Anfragen hinzu, gesendete und empfangene.
  • tag listet die Kontakte auf, die einen bestimmten Tag tragen, folder_id listet einen Ordner auf (sende __none__ für die Kontakte ohne Ordner), und group_id listet die Mitglieder einer Kontaktgruppe auf.
  • profile_id liest die Kontakte eines anderen deiner Profile. limit, skip und bookmark blättern durch die Liste.

Einen Kontakt hinzufügen

create_contact fügt eine Person von Hand hinzu. Es erwartet name und email, die Pflicht sind, und optional phone, company, job_title sowie account_type auf personal oder business gesetzt, was einem Modell das Raten erspart.

  • Die E-Mail ist der Schlüssel des Adressbuchs. Sendest du eine, die du schon hast, kommt der bestehende Kontakt zurück statt einer zweiten Kopie.
  • source hält fest, woher der Kontakt kam, manual, wenn du nichts sendest, und context ist eine Zeile, die in der Aktivität des Kontakts erscheint.
  • profile_id legt den Kontakt unter einem anderen deiner Profile ab.
  • Niemand wird etwas gefragt, und es wird keine E-Mail gesendet. Es entspricht Ohne Einladung hinzufügen im Dashboard.

Um eine Liste aus dem Code einzulesen, rufe es einmal pro Person auf.

Freundschaftsanfragen

  • add_contact_member sendet eine Anfrage an einen anderen Xuda-Nutzer, gefunden über access_email oder über to_uid.
  • get_contact_members listet deine Anfragen und Verbindungen auf, jeweils mit der Karte der anderen Person. stat akzeptiert einen oder mehrere Anfragestatus zum Auflisten.
  • unfriend_contact erwartet eine contact_id und beendet die Verbindung. Der Kontakt bleibt in deinem Adressbuch.

Einen Kontakt organisieren

Jede davon erwartet eine contact_id.

Archivieren und löschen

Löschen kann nicht rückgängig gemacht werden

Ein mit delete_contact gelöschter Kontakt ist weg. Archivieren ist der richtige Schritt, wenn du einen Kontakt nur aus dem Weg haben willst.

Wie findest du diese Anleitung?

Zuletzt aktualisiert am 16. November 2026