Finds persons by text, email, status or archive state. Lists only id, first and last name, email and status id; use ct_get_person for the whole record.

Shows the whole record of one person.

Writes nothing: returns a plan to create a person, with persons of the same name as possible duplicates. Department ids come from GET /person/masterdata (ct_api_request). Most instances also demand statusId and campusId in fields, both from the same masterdata; an instance that makes the privacy agreement mandatory also demands privacyPolicyAgreementTypeId, privacyPolicyAgreementWhoId and privacyPolicyAgreementDate, which only the user can state. If ChurchTools refuses a duplicate, the result names duplicatePersonId.

Writes nothing: returns a plan that patches only the fields whose value changes; null clears a field.

Writes nothing: returns a plan to delete a person; the preview shows the whole record, as a delete cannot be undone.

Finds groups by text, group type or status. Lists only id, name, group type id and status id; use ct_get_group for the whole group.

Shows a group's id, name, information (type, status, note, meeting time…) and settings. Its roles come from GET /groups/{groupId}/roles (ct_api_request).

Lists a group's members with person id, name, role id (groupTypeRoleId) and membership status.

Writes nothing: returns a plan to create a group. If ChurchTools refuses a group of the same name, the result says so.

Writes nothing: returns a plan that patches only the fields whose value changes; null clears a field. Fields go by their flat names, e.g. name, note, groupStatusId, visibility.

Writes nothing: returns a plan to delete a group and with it every membership; the preview shows the whole group, as a delete cannot be undone.

Writes nothing: returns a plan that adds the person to the group. A person who is already a member is an error; use ct_update_group_member. Role ids come from GET /groups/{groupId}/roles (ct_api_request).

Writes nothing: returns a plan that patches only the membership fields whose value changes: role, status, comment, start and end date.

Writes nothing: returns a plan that removes the person from the group; the preview shows the whole membership.

Lists every calendar the user can see with id, name and visibility.

Lists the occurrences of appointments in the given calendars and date range, each with appointment id, calendar id, title, the occurrence's start and end, and repeatId (0 once, any other value a series). Use ct_get_appointment for the whole appointment.

Shows the stored appointment (for a series: its first occurrence, repeat pattern, exceptions and additional dates) with its calculated dates.

Writes nothing: returns a plan to create an appointment, a single one by default or a series through repeatId in fields.

Writes nothing: returns a plan that changes the stored appointment. ChurchTools has no partial update here, so the plan sends the whole current appointment with the changes; the preview lists the changed fields. For a series the change applies to every occurrence.

Writes nothing: returns a plan to delete an appointment; for a series every occurrence goes. The preview shows the whole appointment, as a delete cannot be undone.

Lists the events in a date range with id, name, start, end, canceled state and their service assignments (id, serviceId, personId, assignee name, isAccepted, isValid). Use ct_get_event for service names and the whole event.

Shows the whole event with each service assignment: its id (the eventServiceId of the service tools), serviceId, service name, personId, assignee name, isAccepted and isValid (false for a superseded or declined assignment).

Lists every service (e.g. sermon, sound) with id, name, service group id and service group name.

Writes nothing: returns a plan that changes whether the event is canceled, its note or its admins; ChurchTools takes no other event field here. Only fields whose value changes are sent.

Writes nothing: returns a plan to delete an event with its service assignments; the preview shows the whole event, as a delete cannot be undone.

Writes nothing: returns a plan that assigns one service assignment of an event (ct_get_event) to a ChurchTools person (personId) or to a name; give exactly one. For a helper without a ChurchTools account, ct_set_external_event_service is the alternative. ChurchTools gives the filled assignment a new id; ct_get_event shows it.

Writes nothing: returns a plan that fills one service assignment of an event (ct_get_event) with the name of a helper who has no ChurchTools account. For a ChurchTools person use ct_assign_event_service. ChurchTools gives the filled assignment a new id; ct_get_event shows it.

Logs in with the configured user. If the account has 2FA, ask the user for the current code and pass it; never guess it. Without 2FA, omit the code. A new call replaces the current session.

Shows whether the configuration is valid, the login state, the logged-in user and the ChurchTools version, build and site name.

Runs the writes of a plan that a ChurchTools write tool returned. Call it only after the user saw the preview and said yes. A token is valid once, for 10 minutes. Every guarded record is re-read first; if one changed, nothing is written.

Finds operations of this instance's ChurchTools REST API by keywords over method, path, summary and tags. Use it for anything no other tool covers, then ct_get_operation for the parameters and ct_api_request to call it.

Shows the parameters and the request body schema of one ChurchTools API operation. Schemas are cut below depth 4, long answers at 20 000 characters.

Calls any operation of the ChurchTools REST API. GET runs at once. POST, PUT, PATCH and DELETE write nothing: they return a plan with a preview and a token for ct_execute_plan. The path must match an operation of the spec, with every value filled in.