QonektoInstall

Summary

Upserts a customer in Ameise by searching with _search criteria; if found, updates with kunde fields excluding _default fields; if not found, creates a new customer with kunde fields and _default fields.

Inputs

• kunde fields (required) — Fields to set on customer (existing or new). Contains options for vermittler_id, anrede_id, vorname, nachname, titel, strasse, plz, ort, land_id, geburtsdatum, beruf, per_du, nationalitaet, rechtsform_id, benutzername_simplr, verstorben, kommunikation (json), details (json). Default: {}.
• _search (required) — Parameter names used to search for existing customer. Supports field names and Kommunikation sub-fields (e.g., kommunikation.email_any). Allows kommunikation.email_any to match any context. Default: [vorname, nachname, kommunikation.email_any].
• _default — Parameters that will only be set for a newly created customer. If a customer is found, these field values are not applied.
• notification settings — Notification settings (only for newly created customer). Includes mitteilung-benutzername, mitteilung-passwort-link, mitteilung-erstinfo-unterbinden.
• requestOptions — Batching, proxy, timeout, and SSL validation settings for the API request.

Output shape

API response body from the Qonekto/Ameise upsert endpoint, containing the customer record.

The operation sends a PUT request to /kunde/upsert. _search determines existing customer match. On match, kunde fields are applied except _default fields; on no match, a new customer is created with kunde fields + _default fields. Notification settings are only applied on create.