---
title: "Create or update a property list"
method: POST
path: "/api/property-lists"
tags: ["Property Lists"]
---

# Create or update a property list

`POST /api/property-lists`

## Request

- Base URL: `https://api.sponsorunited.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.sponsorunited.com/api/property-lists`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/sponsorunited/apis/sponsorunited-api/docs/api/property-lists/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a new property list, or updates the one matching `id`, and replaces its whole set of properties

## Request body

- PropertyListStoreRequest
  - `id` integer, nullable: Omit or send null to create a new list
  - `name` string, required
  - `owner_id` integer, nullable
  - `properties` integer[], required: Every property id the list should contain. A comma-separated string such as 123,456 is also accepted.

## Response `200`

The updated property list

- PropertyListsIndex
  - `id` integer: A named, reusable set of properties created by an administrator.
  - `name` string
  - `owner_id` integer, nullable
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `properties_count` integer: One property list as the administration UI shows it: owner, property count and, when the member properties were loaded, their ids and names.
  - `owner` object, nullable
    - `id` integer
    - `email` string
    - `currency` string
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `deleted_at` string, date-time
    - `last_active_at` string, date-time
    - `is_external` boolean
    - `verified` integer
    - `genuine` integer
    - `hubspot_id` integer
    - `hubspot_synced_on` string, date-time
    - `force_new_password` integer
    - `credentials_sent_at` string, date-time
    - `person_profile` PersonProfile
      - `id` integer
      - `user_id` integer
      - `avatar_id` integer, nullable
      - `person_profile_job_role_id` integer, nullable
      - `market_id` integer, nullable
      - `name` string
      - `job_title` string, nullable
      - `location` string, nullable
      - `school` string, nullable
      - `info` string, nullable
      - `suggested` integer, nullable
      - `previous_suggested` integer, nullable
      - `approved` boolean
      - `created_at` string, date-time
      - `updated_at` string, date-time
      - `deleted_at` string, date-time
  - `properties` object[]: Present only when the member properties were requested
    - `id` integer
    - `name` string

## Other responses

- `201`: The created property list
- `422`: The name is missing or a property, owner or list id does not exist

---

[API](https://skmtc.dev/sponsorunited/apis/sponsorunited-api.md) - [All operations](https://skmtc.dev/sponsorunited/apis/sponsorunited-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sponsorunited/apis/sponsorunited-api/revisions/cbf1ca5bff8f?raw)