---
title: "Create an owner"
method: POST
path: "/owners"
tags: ["Owners"]
---

# Create an owner

`POST /owners`

Create an owner

## Request body

- object
  - `email` string, required
  - `firstName` string, required
  - `lastName` string, required
  - `fullName` string
  - `phone` string
  - `notes` string
  - `address` string
  - `personalAddress` object
    - `street` string
    - `city` string
    - `state` string
    - `zipcode` string
    - `country` string
    - `full` string
  - `active` boolean
  - `locale` 'en-US' | 'en-US-nonAmericanDates' | 'de-DE' | 'es-ES' | 'fr-FR' | 'it-IT' | 'pl-PL' | 'pt-PT'
  - `ownersPortalSettings` object
    - `revenue` boolean
    - `accommodationFare` boolean
    - `netRentalIncome` boolean
    - `rentalIncome` boolean
    - `netAccommodationFare` boolean
    - `revPal` boolean
    - `occupancy` boolean
    - `bookedNights` boolean
    - `bookingInquiresCount` boolean
    - `avgNightlyRate` boolean
    - `avgBookingValue` boolean
    - `avgGuestStay` boolean
    - `platformBreakdown` boolean
    - `nightlyRate` boolean
    - `minNights` boolean
    - `showInternalNotesForBlocks` boolean
    - `bookingSource` boolean
    - `hostPayout` boolean
    - `showReservedReservations` boolean
    - `showReservationTooltips` boolean
    - `showGuestFullName` boolean
    - `showGuestEmail` boolean
    - `showGuestPhone` boolean
    - `allowReservations` boolean
    - `allowChangeCheckinCheckoutTime` boolean
    - `showNotesForCoOwnerReservations` boolean
    - `ownerReservationRevenueLoss` boolean
    - `ownerReservationBookedNights` boolean
    - `upcomingReservations` boolean
    - `showOptionalCleaningService` boolean
    - `showOptionalLinenService` boolean
    - `guestsReports` boolean
    - `guestsReportsViewId` string
    - `showHelpCenter` boolean
    - `showOverallGuestRating` boolean
    - `showGuestReviews` boolean
    - `showGuestReviewsHigherThan4` boolean
    - `showInspectionTasks` boolean
    - `showCleaningTasks` boolean
  - `businessInformation` object
    - `businessType` object
      - `type` 'INDIVIDUAL' | 'LLC_LTD' | 'CORPORATION' | 'PARTNERSHIP' | 'TRUST' | 'OTHER' — Business type classification
      - `other` string — Custom business type description when type is OTHER
    - `address` object
      - `street` string
      - `city` string
      - `state` string
      - `zipcode` string
      - `country` string
      - `full` string
    - `businessName` string
    - `vatIdentificationNumber` string
    - `vatRate` number
    - `ownerCommission` number
  - `birthday` string, date-time
  - `anniversary` string, date-time
  - `listings` string[]
  - `picture` object
    - `regular` string
    - `thumbnail` string
    - `large` string
  - `guestId` string
  - `guestIds` string[]

## Response `201`

- object
  - `_id` string, required — Owner id
  - `accountId` string, required — Account id
  - `guestId` string — Guest id used for owner reservations
  - `guestIds` string[] — Array of friends & family guests ids for this owner
  - `listings` object — Array of listings ids
  - `email` string, required
  - `firstName` string, required
  - `lastName` string, required
  - `fullName` string
  - `notes` string
  - `address` string
  - `personalAddress` object
    - `street` string
    - `city` string
    - `state` string
    - `zipcode` string
    - `country` string
    - `full` string
  - `phone` string
  - `active` boolean
  - `locale` string
  - `createdAt` string, date-time
  - `deletedAt` string, date-time
  - `allowReservations` boolean — Deprecated. Use ownersPortalSettings.allowReservations
  - `showReservationTooltips` boolean — Deprecated. Use ownersPortalSettings.allowReservations
  - `ownersPortalSettings` object
    - `revenue` boolean
    - `accommodationFare` boolean
    - `netRentalIncome` boolean
    - `rentalIncome` boolean
    - `netAccommodationFare` boolean
    - `revPal` boolean
    - `occupancy` boolean
    - `bookedNights` boolean
    - `bookingInquiresCount` boolean
    - `avgNightlyRate` boolean
    - `avgBookingValue` boolean
    - `avgGuestStay` boolean
    - `platformBreakdown` boolean
    - `nightlyRate` boolean
    - `minNights` boolean
    - `showInternalNotesForBlocks` boolean
    - `bookingSource` boolean
    - `hostPayout` boolean
    - `showReservedReservations` boolean
    - `showReservationTooltips` boolean
    - `showGuestFullName` boolean
    - `showGuestEmail` boolean
    - `showGuestPhone` boolean
    - `allowReservations` boolean
    - `allowChangeCheckinCheckoutTime` boolean
    - `showNotesForCoOwnerReservations` boolean
    - `ownerReservationRevenueLoss` boolean
    - `ownerReservationBookedNights` boolean
    - `upcomingReservations` boolean
    - `showOptionalCleaningService` boolean
    - `showOptionalLinenService` boolean
    - `guestsReports` boolean
    - `guestsReportsViewId` string
    - `showHelpCenter` boolean
    - `showOverallGuestRating` boolean
    - `showGuestReviews` boolean
    - `showGuestReviewsHigherThan4` boolean
    - `showInspectionTasks` boolean
    - `showCleaningTasks` boolean
  - `businessInformation` object
    - `businessType` object
      - `type` 'INDIVIDUAL' | 'LLC_LTD' | 'CORPORATION' | 'PARTNERSHIP' | 'TRUST' | 'OTHER' — Business type classification
      - `other` string — Custom business type description when type is OTHER
    - `address` object
      - `street` string
      - `city` string
      - `state` string
      - `zipcode` string
      - `country` string
      - `full` string
    - `businessName` string
    - `vatIdentificationNumber` string
    - `vatRate` number
    - `ownerCommission` number
  - `birthday` string, date-time
  - `anniversary` string, date-time
  - `picture` object
    - `regular` string
    - `thumbnail` string
    - `large` string
  - `hasLoggedInAtLeastOnce` boolean — Information about first log in
  - `roles` string — Authorized user role
  - `account` object — Account information
    - `_id` string, required
    - `accountCategorization` number
    - `active` boolean
    - `createdAt` string, date-time
    - `currency` string
    - `name` string
    - `companyLogo` string
    - `companyInformation` object
      - `name` string
      - `contactEmail` string
      - `country` string
      - `city` string
      - `address` string
      - `zipCode` string
      - `contactPhone` string
      - `contactFirstname` string
      - `contactLastname` string
      - `vatNum` string
      - `businessType` string

## Other responses

- `400`

---

[API](https://skmtc.net/guesty/apis/guesty-open-api.md) · [All operations](https://skmtc.net/guesty/apis/guesty-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/guesty/guesty-open-api/versions/7c62644070f2/schema)