# Create or update a multifamily property

Create a new multifamily property or update an existing one

Endpoint: POST /multifamily_properties
Version: 1.1.1
Security: BearerAuth

## Request fields (application/json):

  - `id` (string)
    Unique identifier for the multifamily property. If provided, the property will be updated; if not, a new property will be created.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `community_name` (string, required)
    Name of the multifamily community
    Example: "Sunset Towers"

  - `building_count` (integer, required)
    Number of buildings in the property
    Example: 3

  - `unit_count` (integer, required)
    Total number of units in the property
    Example: 75

  - `description` (string)
    Description of the property
    Example: "Luxury apartment community with amenities"

  - `structure_type` (string, required)
    Type of building structure
    Enum: "Mid Rise", "High Rise", "Garden Style"

  - `year_built` (integer, required)
    Year the property was built
    Example: 2008

  - `photos` (array, required)
    Photos of the property

  - `photos.path` (string, required)
    URL or path to the property photo
    Example: "https://example.com/images/sunset-towers.jpg"

  - `photos.hidden` (boolean, required)
    Whether the photo is hidden

  - `external_ids` (object)
    External identifiers for the property
    Example: {"mls_id":"MLS12345","yardi_id":"Y7890"}

  - `text_address` (string, required)
    Full text address of the property
    Example: "123 Main St, San Francisco, CA 94111"

  - `account_id` (string, required)
    ID of the account that owns the property. Must be a valid account ID that the API key has access to.
    Example: "4b88ff32-8ba0-4bbf-8e60-c789909ac176"

  - `deleted` (boolean)
    Whether the property is deleted

## Response 200 fields (application/json):

  - `id` (string, required)
    Unique identifier for the multifamily property
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `community_name` (string, required)
    Name of the multifamily community
    Example: "Sunset Towers"

  - `building_count` (integer)
    Number of buildings in the property
    Example: 3

  - `unit_count` (integer)
    Total number of units in the property
    Example: 75

  - `description` (string)
    Description of the property
    Example: "Luxury apartment community with amenities"

  - `structure_type` (string)
    Type of building structure
    Enum: "Mid Rise", "High Rise", "Garden Style"

  - `year_built` (integer)
    Year the property was built
    Example: 2008

  - `photos` (array)
    Photos of the property

  - `photos.path` (string, required)
    URL or path to the property photo
    Example: "https://example.com/images/sunset-towers.jpg"

  - `photos.hidden` (boolean, required)
    Whether the photo is hidden

  - `external_ids` (object)
    External identifiers for the property
    Example: {"mls_id":"MLS12345","yardi_id":"Y7890"}

  - `text_address` (string, required)
    Full text address of the property
    Example: "123 Main St, San Francisco, CA 94111"

  - `account_id` (string, required)
    ID of the account that owns the property
    Example: "4b88ff32-8ba0-4bbf-8e60-c789909ac176"

  - `created_at` (string, required)
    Timestamp when the property was created
    Example: "2023-01-15T12:00:00Z"

  - `updated_at` (string, required)
    Timestamp when the property was last updated
    Example: "2023-01-16T14:30:00Z"

## Response 400 fields (application/json):

  - `error` (string, required)
    Error message
    Example: "Invalid request parameters"

  - `details` (array)
    Detailed error information
    Example: [{"keyword":"required","dataPath":"","schemaPath":"#/required","params":{"missingProperty":"account_id"},"message":"should have required property 'account_id'"}]

## Response 401 fields (application/json):

  - `error` (string, required)
    Error message
    Example: "Invalid request parameters"

  - `details` (array)
    Detailed error information
    Example: [{"keyword":"required","dataPath":"","schemaPath":"#/required","params":{"missingProperty":"account_id"},"message":"should have required property 'account_id'"}]

## Response 500 fields (application/json):

  - `error` (string, required)
    Error message
    Example: "Invalid request parameters"

  - `details` (array)
    Detailed error information
    Example: [{"keyword":"required","dataPath":"","schemaPath":"#/required","params":{"missingProperty":"account_id"},"message":"should have required property 'account_id'"}]