--- updatedAt: 2026-04-23T09:30:40.000Z agentTools: projectIndex: https://open-api-docs.guesty.com/llms.txt --- # Create multiple owners with assigned listings Create multiple owners with assigned listings # OpenAPI definition ```json { "openapi": "3.0.3", "info": { "title": "GUESTY OPEN API", "description": "Guesty Open API documentation", "version": "1" }, "servers": [ { "url": "https://open-api.guesty.com/v1" } ], "security": [ { "bearerAuth": [] } ], "tags": [ { "name": "Owners" } ], "paths": { "/owners/bulk": { "post": { "operationId": "OwnersBulkOpenApiController_createBulk", "summary": "Create multiple owners with assigned listings", "description": "Create multiple owners with assigned listings", "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "email": { "type": "string" }, "firstName": { "type": "string" }, "lastName": { "type": "string" }, "fullName": { "type": "string" }, "phone": { "type": "string" }, "notes": { "type": "string" }, "address": { "type": "string" }, "personalAddress": { "type": "object", "properties": { "street": { "type": "string" }, "city": { "type": "string" }, "state": { "type": "string" }, "zipcode": { "type": "string" }, "country": { "type": "string" }, "full": { "type": "string" } } }, "active": { "type": "boolean" }, "locale": { "enum": [ "en-US", "en-US-nonAmericanDates", "de-DE", "es-ES", "fr-FR", "it-IT", "pl-PL", "pt-PT" ], "type": "string" }, "ownersPortalSettings": { "type": "object", "properties": { "revenue": { "type": "boolean" }, "accommodationFare": { "type": "boolean" }, "netRentalIncome": { "type": "boolean" }, "rentalIncome": { "type": "boolean" }, "netAccommodationFare": { "type": "boolean" }, "revPal": { "type": "boolean" }, "occupancy": { "type": "boolean" }, "bookedNights": { "type": "boolean" }, "bookingInquiresCount": { "type": "boolean" }, "avgNightlyRate": { "type": "boolean" }, "avgBookingValue": { "type": "boolean" }, "avgGuestStay": { "type": "boolean" }, "platformBreakdown": { "type": "boolean" }, "nightlyRate": { "type": "boolean" }, "minNights": { "type": "boolean" }, "showInternalNotesForBlocks": { "type": "boolean" }, "bookingSource": { "type": "boolean" }, "hostPayout": { "type": "boolean" }, "showReservedReservations": { "type": "boolean" }, "showReservationTooltips": { "type": "boolean" }, "showGuestFullName": { "type": "boolean" }, "showGuestEmail": { "type": "boolean" }, "showGuestPhone": { "type": "boolean" }, "allowReservations": { "type": "boolean" }, "allowChangeCheckinCheckoutTime": { "type": "boolean" }, "showNotesForCoOwnerReservations": { "type": "boolean" }, "ownerReservationRevenueLoss": { "type": "boolean" }, "ownerReservationBookedNights": { "type": "boolean" }, "upcomingReservations": { "type": "boolean" }, "showOptionalCleaningService": { "type": "boolean" }, "showOptionalLinenService": { "type": "boolean" }, "guestsReports": { "type": "boolean" }, "guestsReportsViewId": { "type": "string" }, "showHelpCenter": { "type": "boolean" }, "showOverallGuestRating": { "type": "boolean" }, "showGuestReviews": { "type": "boolean" }, "showGuestReviewsHigherThan4": { "type": "boolean" }, "showInspectionTasks": { "type": "boolean" }, "showCleaningTasks": { "type": "boolean" } } }, "businessInformation": { "type": "object", "properties": { "businessType": { "type": "object", "properties": { "type": { "enum": [ "INDIVIDUAL", "LLC_LTD", "CORPORATION", "PARTNERSHIP", "TRUST", "OTHER" ], "type": "string", "description": "Business type classification" }, "other": { "type": "string", "description": "Custom business type description when type is OTHER" } } }, "address": { "type": "object", "properties": { "street": { "type": "string" }, "city": { "type": "string" }, "state": { "type": "string" }, "zipcode": { "type": "string" }, "country": { "type": "string" }, "full": { "type": "string" } } }, "businessName": { "type": "string" }, "vatIdentificationNumber": { "type": "string", "maxLength": 30 }, "vatRate": { "type": "number", "minimum": 0, "maximum": 100 }, "ownerCommission": { "type": "number", "minimum": 0, "maximum": 100 } } }, "birthday": { "format": "date-time", "type": "string" }, "anniversary": { "format": "date-time", "type": "string" }, "listings": { "type": "array", "items": { "type": "string" } }, "picture": { "type": "object", "properties": { "regular": { "type": "string" }, "thumbnail": { "type": "string" }, "large": { "type": "string" } } }, "guestId": { "type": "string" }, "guestIds": { "type": "array", "items": { "type": "string" } } }, "required": [ "email", "firstName", "lastName" ] } } } } }, "responses": { "201": { "description": "", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "_id": { "type": "string", "example": "611d02b7c9c54b01736ae01d", "description": "Owner id" }, "accountId": { "type": "string", "example": "611cf837c9c54b01736ae01c", "description": "Account id" }, "guestId": { "type": "string", "example": "611cf837c9c54b01736ae01c", "description": "Guest id used for owner reservations" }, "guestIds": { "example": [ "611cf837c9c54b01736ae01c" ], "description": "Array of friends & family guests ids for this owner", "type": "array", "items": { "type": "string" } }, "listings": { "type": "object", "example": [ "611cf837c9c54b01736ae01c" ], "description": "Array of listings ids" }, "email": { "type": "string", "example": "example@email.com" }, "firstName": { "type": "string", "example": "John" }, "lastName": { "type": "string", "example": "Doe" }, "fullName": { "type": "string", "example": "John Doe" }, "notes": { "type": "string" }, "address": { "type": "string" }, "personalAddress": { "type": "object", "properties": { "street": { "type": "string" }, "city": { "type": "string" }, "state": { "type": "string" }, "zipcode": { "type": "string" }, "country": { "type": "string" }, "full": { "type": "string" } } }, "phone": { "type": "string" }, "active": { "type": "boolean" }, "locale": { "type": "string", "example": "en-US" }, "createdAt": { "format": "date-time", "type": "string" }, "deletedAt": { "format": "date-time", "type": "string" }, "allowReservations": { "type": "boolean", "deprecated": true, "description": "Deprecated. Use ownersPortalSettings.allowReservations" }, "showReservationTooltips": { "type": "boolean", "deprecated": true, "description": "Deprecated. Use ownersPortalSettings.allowReservations" }, "ownersPortalSettings": { "type": "object", "properties": { "revenue": { "type": "boolean" }, "accommodationFare": { "type": "boolean" }, "netRentalIncome": { "type": "boolean" }, "rentalIncome": { "type": "boolean" }, "netAccommodationFare": { "type": "boolean" }, "revPal": { "type": "boolean" }, "occupancy": { "type": "boolean" }, "bookedNights": { "type": "boolean" }, "bookingInquiresCount": { "type": "boolean" }, "avgNightlyRate": { "type": "boolean" }, "avgBookingValue": { "type": "boolean" }, "avgGuestStay": { "type": "boolean" }, "platformBreakdown": { "type": "boolean" }, "nightlyRate": { "type": "boolean" }, "minNights": { "type": "boolean" }, "showInternalNotesForBlocks": { "type": "boolean" }, "bookingSource": { "type": "boolean" }, "hostPayout": { "type": "boolean" }, "showReservedReservations": { "type": "boolean" }, "showReservationTooltips": { "type": "boolean" }, "showGuestFullName": { "type": "boolean" }, "showGuestEmail": { "type": "boolean" }, "showGuestPhone": { "type": "boolean" }, "allowReservations": { "type": "boolean" }, "allowChangeCheckinCheckoutTime": { "type": "boolean" }, "showNotesForCoOwnerReservations": { "type": "boolean" }, "ownerReservationRevenueLoss": { "type": "boolean" }, "ownerReservationBookedNights": { "type": "boolean" }, "upcomingReservations": { "type": "boolean" }, "showOptionalCleaningService": { "type": "boolean" }, "showOptionalLinenService": { "type": "boolean" }, "guestsReports": { "type": "boolean" }, "guestsReportsViewId": { "type": "string" }, "showHelpCenter": { "type": "boolean" }, "showOverallGuestRating": { "type": "boolean" }, "showGuestReviews": { "type": "boolean" }, "showGuestReviewsHigherThan4": { "type": "boolean" }, "showInspectionTasks": { "type": "boolean" }, "showCleaningTasks": { "type": "boolean" } } }, "businessInformation": { "type": "object", "properties": { "businessType": { "type": "object", "properties": { "type": { "enum": [ "INDIVIDUAL", "LLC_LTD", "CORPORATION", "PARTNERSHIP", "TRUST", "OTHER" ], "type": "string", "description": "Business type classification" }, "other": { "type": "string", "description": "Custom business type description when type is OTHER" } } }, "address": { "type": "object", "properties": { "street": { "type": "string" }, "city": { "type": "string" }, "state": { "type": "string" }, "zipcode": { "type": "string" }, "country": { "type": "string" }, "full": { "type": "string" } } }, "businessName": { "type": "string" }, "vatIdentificationNumber": { "type": "string", "maxLength": 30 }, "vatRate": { "type": "number", "minimum": 0, "maximum": 100 }, "ownerCommission": { "type": "number", "minimum": 0, "maximum": 100 } } }, "birthday": { "format": "date-time", "type": "string" }, "anniversary": { "format": "date-time", "type": "string" }, "picture": { "type": "object", "properties": { "regular": { "type": "string" }, "thumbnail": { "type": "string" }, "large": { "type": "string" } } }, "hasLoggedInAtLeastOnce": { "type": "boolean", "description": "Information about first log in" }, "roles": { "type": "string", "example": "owner", "description": "Authorized user role" }, "account": { "example": "611d02b7c9c54b01736ae01d", "description": "Account information", "allOf": [ { "type": "object", "properties": { "_id": { "type": "string" }, "accountCategorization": { "type": "number" }, "active": { "type": "boolean" }, "createdAt": { "format": "date-time", "type": "string" }, "currency": { "type": "string" }, "name": { "type": "string" }, "companyLogo": { "type": "string" }, "companyInformation": { "type": "object", "properties": { "name": { "type": "string" }, "contactEmail": { "type": "string" }, "country": { "type": "string" }, "city": { "type": "string" }, "address": { "type": "string" }, "zipCode": { "type": "string" }, "contactPhone": { "type": "string" }, "contactFirstname": { "type": "string" }, "contactLastname": { "type": "string" }, "vatNum": { "type": "string" }, "businessType": { "type": "string" } } } }, "required": [ "_id" ] } ] } }, "required": [ "_id", "accountId", "email", "firstName", "lastName" ] } } } } }, "400": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "message": { "type": "string", "example": "Validation Failed Error" }, "code": { "type": "string", "example": "VALIDATION_FAILED" }, "status": { "enum": [ 100, 101, 102, 103, 200, 201, 202, 203, 204, 205, 206, 300, 301, 302, 303, 304, 307, 308, 400, 401, 402, 403, 404, 405, 406, 407, 408, 409, 410, 411, 412, 413, 414, 415, 416, 417, 418, 421, 422, 424, 428, 429, 500, 501, 502, 503, 504, 505 ], "type": "number", "example": 400 }, "data": { "example": [ "property1 must not be less than 0", "property1 must be an integer number" ], "type": "array", "items": { "type": "string" } } }, "required": [ "message", "code", "status", "data" ] } }, "required": [ "error" ] } } } } }, "tags": [ "Owners" ] } } }, "components": { "securitySchemes": { "bearerAuth": { "type": "apiKey", "name": "authorization", "in": "header" } } }, "x-kong-upstream-prefix": "/integrations/brands", "x-kong-route-transformations": [ { "configuration": "v1", "routeExtpath": "/account-brands", "stripPrefix": "/v1/account-brands" } ] } ```