---
title: "CreateListingRequest"
url: "https://real-estate-agency.apim.eu/apis/listing-creation/versions/ccce93aa-5880-49f4-849d-af24517f6c76/schemas/CreateListingRequest"
---

> Full API specification: https://real-estate-agency.apim.eu/apis/listing-creation/versions/ccce93aa-5880-49f4-849d-af24517f6c76.md

# CreateListingRequest

## OpenAPI definition

```yaml
openapi: 3.0.3
info:
  title: Listing Creation
  version: 1.0.0
servers:
  - url: https://api.realestateagency.example/v1
    description: Production
  - url: https://sandbox.api.realestateagency.example/v1
    description: Sandbox - data is reset nightly
components:
  schemas:
    Section:
      type: string
      description: Content block of the listing.
      enum:
        - location
        - features
        - energy
        - floor_plan
        - commission
        - neighborhood
        - history
    CreateListingRequest:
      type: object
      required:
        - property_id
        - template_id
      properties:
        property_id:
          type: string
          description: Property the listing is generated from.
          example: prop_8f2c1a
        template_id:
          type: string
          description: Design template of the agency.
          example: tpl_classic
        language:
          type: string
          description: Language of the generated document. Useful when marketing to
            international buyers.
          enum:
            - en
            - es
            - fr
            - de
          default: en
        sections:
          type: array
          description: Order and selection of sections. Defaults to the template's
            sections if omitted.
          items:
            $ref: "#/components/schemas/Section"
        internal_note:
          type: string
          maxLength: 500
          description: Internal remark; does not appear in the document.
          example: Owner prefers viewings starting September 1st.
```