Aller au contenu

Contacts

Les personnes et les entreprises avec lesquelles vous travaillez.

Ouvrir Contacts
Vérifié par rapport au tableau de bord le 20 novembre 2026

Contacts n'a pas de microservice propre. Ses méthodes publiques appartiennent au microservice account, qui contient aussi Profils, et au microservice team pour les demandes d'ami. Chacune agit pour le compte dont vous utilisez la clé API.

Les groupes, les étiquettes, les champs personnalisés, Garder le contact, la détection des doublons, l'import et le choix d'un forfait n'ont aujourd'hui aucune méthode publique. Cela se fait dans le tableau de bord.

Envoyez une requête à une méthode avec votre clé :

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',
    },
)

Une requête refusée renvoie un code négatif et en donne la raison dans data. La plupart des méthodes ci-dessous acceptent aussi un workspace_id facultatif, pour agir dans un espace de travail dont vous êtes propriétaire autre que votre espace principal.

Lire les contacts

get_contacts liste les contacts.

  • _id ou contact_id renvoie un seul contact.
  • search filtre la liste par une chaîne de recherche, et name par un nom.
  • filter_type restreint la liste, par exemple à archived, shared, pinned, favorites ou online. Sans ce paramètre, elle liste les contacts actifs avec les demandes de connexion en attente.
  • with_requests défini à true ajoute aussi à une liste filtrée les demandes en attente, envoyées et reçues.
  • tag liste les contacts qui portent une étiquette, folder_id liste un dossier (envoyez __none__ pour les contacts sans dossier) et group_id liste les membres d'un groupe de contacts.
  • profile_id lit les contacts d'un autre de vos profils. limit, skip et bookmark paginent la liste.

Ajouter un contact

create_contact ajoute une personne à la main. Il prend name et email, obligatoires, et facultativement phone, company, job_title et account_type défini à personal ou business, ce qui évite à un modèle d'avoir à deviner.

  • L'e-mail est la clé du carnet. En envoyer un que vous avez déjà renvoie le contact existant au lieu d'une seconde copie.
  • source indique d'où vient le contact, manual si vous n'en envoyez pas, et context est une ligne qui s'affiche dans l'activité du contact.
  • profile_id classe le contact sous un autre de vos profils.
  • Personne n'est sollicité et aucun e-mail n'est envoyé. C'est équivalent à Ajouter sans invitation dans le tableau de bord.

Pour importer une liste depuis du code, appelez-le une fois par personne.

Demandes d'ami

  • add_contact_member envoie une demande à un autre utilisateur Xuda, trouvé par access_email ou par to_uid.
  • get_contact_members liste vos demandes et vos connexions, chacune avec la fiche de l'autre personne. stat accepte un ou plusieurs statuts de demande à lister.
  • unfriend_contact prend un contact_id et met fin à la connexion. Le contact reste dans votre carnet.

Organiser un contact

Chacune de ces méthodes prend un contact_id.

Archiver et supprimer

Une suppression est irréversible

Un contact supprimé avec delete_contact est perdu. Archiver est l'étape à utiliser quand vous voulez seulement écarter un contact.

Que pensez-vous de ce guide ?

Dernière mise à jour le 16 novembre 2026