Naar de inhoud springen

Contacten

De mensen en bedrijven met wie je werkt.

Contacten openen
Gecontroleerd aan de hand van het dashboard op 20 november 2026

Contacten heeft geen eigen microservice. De publieke methoden horen bij de accountmicroservice, die ook Profielen bevat, en bij de teammicroservice voor vriendschapsverzoeken. Elke methode werkt voor het account waarvan je de API-sleutel gebruikt.

Groepen, tags, eigen velden, Houd contact, de controle op dubbelen, het importeren en het kiezen van een abonnement hebben op dit moment geen publieke methode. Die doe je in het dashboard.

Stuur een verzoek naar een methode met je sleutel:

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

Een geweigerd verzoek antwoordt met een negatieve code en zegt in data waarom. De meeste methoden hieronder nemen ook een optionele workspace_id, om te werken in een werkruimte die je bezit, anders dan je hoofdwerkruimte.

Contacten lezen

get_contacts toont de contacten.

  • _id of contact_id geeft een contact.
  • search filtert de lijst op een zoekreeks, en name op een naam.
  • filter_type beperkt de lijst, bijvoorbeeld tot archived, shared, pinned, favorites of online. Weggelaten toont hij de actieve contacten samen met de verzoeken om te verbinden die wachten.
  • with_requests op true voegt de openstaande verzoeken, verstuurd en ontvangen, ook aan een gefilterde lijst toe.
  • tag toont de contacten met een tag, folder_id toont een map (stuur __none__ voor de contacten in geen enkele map) en group_id toont de leden van een contactgroep.
  • profile_id leest de contacten van een ander profiel van jou. limit, skip en bookmark pagineren de lijst.

Een contact toevoegen

create_contact voegt een persoon met de hand toe. Hij neemt name en email, die verplicht zijn, en optioneel phone, company, job_title en account_type op personal of business, wat een model het raden bespaart.

  • Het e-mailadres is de sleutel van het boek. Een adres sturen dat je al hebt, geeft het bestaande contact terug in plaats van een tweede kopie.
  • source legt vast waar het contact vandaan kwam, manual als je er geen stuurt, en context is een regel die op de activiteit van het contact verschijnt.
  • profile_id bergt het contact op onder een ander profiel van jou.
  • Niemand krijgt een vraag en er wordt geen e-mail verstuurd. Het is hetzelfde als Toevoegen zonder uitnodiging in het dashboard.

Om een lijst vanuit code binnen te halen, roep je het eenmaal per persoon aan.

Vriendschapsverzoeken

  • add_contact_member stuurt een verzoek naar een andere Xuda-gebruiker, gevonden met access_email of met to_uid.
  • get_contact_members toont je verzoeken en verbindingen, elk met de kaart van de andere persoon. stat neemt een of meer verzoekstatussen om te tonen.
  • unfriend_contact neemt een contact_id en beëindigt de verbinding. Het contact blijft in je boek.

Een contact ordenen

Elk van deze neemt een contact_id.

Archiveren en verwijderen

Verwijderen kan niet ongedaan worden gemaakt

Een contact dat met delete_contact is verwijderd, is weg. Archiveren is de stap om te gebruiken als je een contact alleen uit de weg wilt hebben.

Hoe vind je deze gids?

Laatst bijgewerkt op 19 november 2026