---
title: "Create or update listing"
method: PUT
path: "/partner/v1/listings/{externalListingId}"
tags: ["Partner"]
---

# Create or update listing

`PUT /partner/v1/listings/{externalListingId}`

Create or update a listing in Venturu's system. If the listing with the specified external ID already exists, its information will be updated. If not, a new listing will be created.

## Path parameters

- `externalListingId` string, required — The ID of the listing from your system.

## Request body

- PutListingRequestSchema
  - `brokerExternalId` string, nullable — The ID of the broker this listing belongs to (from your system). Use this if the broker already exists.
  - `broker` InlineBrokerSchema
    - `name` string, required — The full name of the broker.
    - `email` string, required — The email address of the broker.
    - `phone` string, nullable — The phone number of the broker.
    - `avatarUrl` string, nullable — A URL to the broker's profile picture.
    - `forwardingEmail` string, nullable — If leads should be forwarded to a specific email address (i.e. in case of CRMs), this value can be specified.
    - `profile` object, nullable — Additional profile information about the broker.
      - `bio` string, nullable — A short biography of the broker.
      - `website` string, nullable — The broker's personal or professional website.
      - `linkedInUrl` string, nullable — The broker's LinkedIn profile URL.
    - `licenses` object[], nullable — A list of licenses held by the broker.
      - `licenseNumber` string, required — The license number of the broker.
      - `state` string, required — The state where the license is valid. It is recommended that this is specified as the full name of the state.
      - `country` string, required — The country where the license is valid. It is recommended that this is specified as a two-letter ISO country code.
    - `serviceAreas` object[], nullable — A list of service areas covered by the broker.
      - `neighborhood` string, nullable — The neighborhood served by the broker.
      - `city` string, nullable — The city served by the broker.
      - `county` string, nullable — The county served by the broker.
      - `state` string, required — The state served by the broker. It is recommended that this is specified as the full name of the state.
      - `country` string, required — The country served by the broker. It is recommended that this is specified as a two-letter ISO country code.
  - `status` object, required
  - `title` string, nullable — A short title for the listing. Note that this title will not be used publicly.
  - `description` string, nullable — A detailed description of the listing. Note that we may optimize the description based on the listing's overall parameters.
  - `businessType` string, required — The type of business being listed (e.g., 'Restaurant', etc.).
  - `establishedAt` object, nullable — The date when the business was established (ISO 8601 format).
  - `location` object, required — Location information about the business.
    - `streetAddress1` string, nullable — The primary street address of the business.
    - `streetAddress2` string, nullable — The secondary street address of the business.
    - `city` string, nullable — The city where the business is located.
    - `state` string, nullable — The state where the business is located. It is recommended that this is specified as the full name of the state.
    - `postalCode` string, nullable — The postal/ZIP code of the business.
    - `country` string, required — The country where the business is located. It is recommended that this is specified as a two-letter ISO country code.
    - `visibility` object, required
  - `financials` object, nullable — Financial details of the listing.
    - `askingPrice` number, nullable — The asking price of the listing in dollars.
    - `revenue` number, nullable — The annual revenue of the business in dollars.
    - `profit` number, nullable — The annual profit of the business in dollars.
    - `sde` number, nullable — The Seller's Discretionary Earnings (SDE) of the business in dollars.
    - `inventory` number, nullable — The value of the inventory included in the sale in dollars.
    - `ffande` number, nullable — The value of furniture, fixtures, and equipment (FF&E) included in the sale in dollars.
  - `training` object, nullable — Details about training provided to the new business owner.
    - `available` boolean, required — Indicates if training is provided to the new business owner.
    - `description` string, nullable — A description of the training provided.
    - `duration` string, nullable — The duration of the training (e.g., '2 Weeks').
    - `cost` number, nullable — The cost of the training in dollars. If not provided or zero, training is assumed to be free.
  - `property` object, nullable — Information about a business' property.
    - `propertyKind` object, required
    - `areaSqft` number, nullable — The area of the property in square feet.
    - `rentData` object, nullable — Information about the rented property. Recommended to provide if propertyKind is 'RENTED'.
      - `amount` number, nullable — The rent amount in dollars.
      - `frequency` object, required
      - `leaseRenewable` boolean, nullable — Whether or not the lease is renewable.
      - `leaseNegotiable` boolean, nullable — Whether or not the lease terms are negotiable.
      - `leaseExpiration` object, nullable — The expiration date of the lease (ISO 8601 format).
      - `leaseDetails` string, nullable — Additional details about the lease.
    - `ownedData` object, nullable — Information about the owned property. Recommended to provide if propertyKind is 'OWNED'.
      - `propertyIncludedInPrice` boolean, nullable — Indicates if the property is included in the listing's asking price.
      - `propertyAskingPrice` number, nullable — The asking price for the property in dollars, if sold separately.
      - `propertyDetails` string, nullable — Additional details about the owned property.
  - `financing` object, nullable — Details about financing options available for the listing.
    - `financingAvailable` boolean, required — Indicates if buyer financing options are available for the listing.
    - `sbaPrequalified` boolean, nullable — Indicates if the business is prequalified for SBA loans.
    - `minimumDownPayment` number, nullable — The minimum down payment required from the buyer in dollars.
    - `buyerCanAssumeLoan` boolean, nullable — Indicates if the buyer can assume existing loans on the business.
  - `photos` object[], nullable — A list of photos associated with the listing.
    - `url` string, required — The URL of the photo.
    - `sortKey` number, required — The sort order of the photo.

## Response `200`

Successful response

- PutListingResponseSchema
  - `status` 'success', required — Indicates that the operation was successful.
  - `message` string, required — A message providing additional information about the operation.
  - `venturuListingId` number, nullable — The Venturu ID of the listing.
  - `venturuListingUrl` string, nullable — The URL of the listing on Venturu. Note that this field may be missing if we failed to generate a slug for the listing but may show up later.

## Other responses

- `201` — HTTP 201

---

[API](https://skmtc.net/venturu/apis/venturu-api-documentation.md) · [All operations](https://skmtc.net/venturu/apis/venturu-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/venturu/venturu-api-documentation/versions/8f58809101f1/schema)