Contacts

Contacts

📄️ List contacts

Lists the organization's contacts. Filters: name, email, phone, is_blacklisted, page, limit. Requires `api_user|contact_view`.

📄️ Create a contact

Requires `api_user|contact_create`. `form_values` holds custom (dynamic-form) fields.

📄️ Contact filterable surface

The contact's filterable surface: `columns` are the contact's own database columns, `fields` are its dynamic (custom) form fields. On the ticket list these map to `contact[<key>]` and `contact_form[<key>]` respectively. Returns a null `form` and an empty `fields` list when the organization has no contact form. Requires `api_user|contact_view`.

📄️ Show a contact

Returns a contact with groups and custom form values. Requires `api_user|contact_view`.

📄️ Delete a contact

Soft-deletes the contact. Requires `api_user|contact_delete`.

📄️ Update a contact

Partial update; at least one field required. `form_values` is optional — only the submitted custom fields are updated and required fields are NOT enforced on update (they are enforced on create). Omit form_values to leave custom fields untouched. Requires `api_user|contact_update`.

📄️ Toggle contact blacklist

Sets the is_blacklisted flag only. Requires `api_user|contact_blacklist`.

📄️ List a contact's tickets

Up to 50 tickets belonging to the contact. Requires `api_user|contact_view_tickets`.

📄️ Contact activity logs

Audit trail for the contact and its tickets (paginated: page, limit). Requires `api_user|contact_activity_logs`.