# HumDov Developer API

> Build integrations that read and write records in HumDov — members, forms, events, attendance and more.

- [Introduction](https://api.humdov.com/introduction.md): What the HumDov v1 API is, what it covers, and how to get started
- [Authentication](https://api.humdov.com/authentication.md): Sending your API key, and what scopes control
- [Pagination & rate limits](https://api.humdov.com/pagination-and-rate-limits.md): How list endpoints paginate, and how often you can call the API
- [Errors](https://api.humdov.com/errors.md): The error response shape and common error codes
- [List members](https://api.humdov.com/api-reference/members/list-members.md): Cursor-paginated list of this org's members.
- [Create a member](https://api.humdov.com/api-reference/members/create-a-member.md): `first_name`, `last_name`, and `email_address` are required.
- [Get a member](https://api.humdov.com/api-reference/members/get-a-member.md)
- [Update a member](https://api.humdov.com/api-reference/members/update-a-member.md): Partial update — only send the fields you want to change.
- [Add/remove tags on a member](https://api.humdov.com/api-reference/tags/addremove-tags-on-a-member.md): Only admin-created, public-privacy tags can be added or removed this way — system and AI-sourced tags (e.g. tags applied automatically) are never touchable via the API, the same rule the dashboard itself enforces. Returns the member's full current (assignable) tag list after applying the change.
- [List tags](https://api.humdov.com/api-reference/tags/list-tags.md): Only tags assignable via the API (admin-created, public privacy) are listed here.
- [List prayer requests](https://api.humdov.com/api-reference/prayer-requests/list-prayer-requests.md)
- [Submit a prayer request](https://api.humdov.com/api-reference/prayer-requests/submit-a-prayer-request.md): Only `description` is required. `sender` defaults to `"Anonymous"` when omitted.
- [Get a prayer request](https://api.humdov.com/api-reference/prayer-requests/get-a-prayer-request.md)
- [List forms](https://api.humdov.com/api-reference/forms/list-forms.md): Read-only. Lets you discover a form's id and its fields before calling the Form Responses endpoints below.
- [Get a form](https://api.humdov.com/api-reference/forms/get-a-form.md): Returns the form plus its fields. Use each field's `id` to key the `answers` object when calling Create Form Response.
- [List form responses](https://api.humdov.com/api-reference/form-responses/list-form-responses.md): Not gated by the form's published/accepting-responses state — you can always review what already came in, regardless of whether the form happens to be open right now (only *submitting* is gated on that).
- [Submit a form response](https://api.humdov.com/api-reference/form-responses/submit-a-form-response.md): Body is `{"answers": {"<field_id>": <value>, ...}}` — one natural-JSON value per field, keyed by the field's `id` (get these from Get Form). Value shape depends on the field's `field_type`:
- [Get a form response](https://api.humdov.com/api-reference/form-responses/get-a-form-response.md)
- [List events](https://api.humdov.com/api-reference/events/list-events.md): Read-only — no create/update via v1.
- [Get an event](https://api.humdov.com/api-reference/events/get-an-event.md)
- [List services](https://api.humdov.com/api-reference/services/list-services.md): Read-only. Lets you discover a service's id before calling the Attendance endpoints below.
- [Get a service](https://api.humdov.com/api-reference/services/get-a-service.md)
- [List attendance for a service](https://api.humdov.com/api-reference/attendance/list-attendance-for-a-service.md): Returns `422 plan_not_supported` if the org's plan doesn't include attendance tracking.
- [Check a member in to a service](https://api.humdov.com/api-reference/attendance/check-a-member-in-to-a-service.md): Looks up the member by `email_address` within your org; auto-creates a guest member if none exists — mirrors the dashboard's own kiosk check-in flow exactly.
- [List departments](https://api.humdov.com/api-reference/departments/list-departments.md): Read-only — no create/update via v1.
- [Get a department](https://api.humdov.com/api-reference/departments/get-a-department.md): `member_ids` is a snapshot captured when each member was added to the department — only the id is guaranteed current. Look each one up via Get Member for up-to-date fields.

## OpenAPI Specs

- [openapi](/openapi.yaml)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.