---
title: "Changes to Create a household"
method: POST
path: "/v1/households"
---

# Changes to Create a household

`POST /v1/households`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-11-03** `173c41bf6be9`: 1 breaking, 2 warning, 16 info

## Changes

- **2026-11-03** `173c41bf6be9`: 1 breaking, 2 warning, 16 info
  - removed the media type `application/json` for the response with the status `400`
  - added the new `PastClient` enum value to the `type` response property for the response status `201`
  - added the new `inactive` enum value to the `people/items/email_addresses/items/email_type` response property for the response status `201`
  - added the new optional request property `custom_fields`
  - added the new optional request property `drivers_license_number`
  - added the new optional request property `head_of_household`
  - added the new optional request property `preferred_name`
  - added the new optional request property `ssn`
  - added the new optional request property `tag_ids`
  - added the media type `application/json` for the response with the status `403`
  - added the non-success response with the status `429`
  - added the optional property `people/items/addresses/items/id` to the response with the `201` status
  - added the optional property `people/items/date_of_death` to the response with the `201` status
  - added the optional property `people/items/email_addresses/items/id` to the response with the `201` status
  - added the optional property `people/items/employments/items/business_id` to the response with the `201` status
  - added the optional property `people/items/phone_numbers/items/id` to the response with the `201` status
  - added the optional property `tags` to the response with the `201` status
  - added the required property `people/items/created_at` to the response with the `201` status
  - added the required property `people/items/updated_at` to the response with the `201` status

---

[Operation](https://skmtc.dev/slant/apis/slant-public-api-v1/docs/v1/households/post.md) - [API](https://skmtc.dev/slant/apis/slant-public-api-v1.md) - [Page](https://skmtc.dev/slant/apis/slant-public-api-v1/changes/v1/households/post)