bexio Contacts
bexio_contactsManage contacts in the bexio central address book: list, search, create, update, delete, and restore contacts referenced by quotes, orders, invoices, and projects.
Instructions
Manage bexio contacts (companies and persons; the central address book referenced by quotes, orders, invoices, projects). Actions: "list" (all contacts; optional limit/offset/order_by [id|nr|name_1|updated_at, append "_desc"], show_archived), "search" (search_criteria required; useful searchable fields: id, nr, name_1, name_2, mail, postcode, city, country_id, contact_type_id, contact_group_ids, user_id, updated_at; optional list params and show_archived), "get" (contact by id; optional show_archived; includes base64 profile_image), "create" (payload required: contact_type_id [1=company, 2=person], name_1, user_id, owner_id), "update" (id + payload of fields to change), "delete" (permanently deletes the contact — cannot be undone; a deleted contact can only be restored shortly afterwards via the restore action), "bulk_create" (contacts array of contact payloads, same required fields as create), "restore" (restore a deleted contact by id).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Contact id (required for get/update/delete/restore) | |
| limit | No | Maximum number of results (default 500, max 2000) | |
| action | Yes | Operation to perform | |
| offset | No | Number of results to skip (pagination) | |
| payload | No | Contact fields. Required on create/bulk_create: contact_type_id, name_1, user_id, owner_id. Note: the API spec also marks these four fields as required on update (v2EditContact), though partial edits generally work. The legacy combined "address" field is deprecated (read-only); use street_name/house_number/address_addition. | |
| contacts | No | Contact payloads for "bulk_create" | |
| order_by | No | Field to order by; append "_desc" for descending (e.g. "id_desc") | |
| show_archived | No | Show archived elements only (list/search/get) | |
| search_criteria | No | Search conditions, combined with logical AND |