Create Photo

This endpoint creates one or more photos for a specific Airbnb listing, including captions, sort order, category, and associated room or facility IDs.

Endpoint

POST

https://connect-sandbox.su-api.com/SUAPI/jservice/airbnb/photo/create

---

Header

-app-id: App Id
Authorization: Basic Authorization
Content-Type: application/json

Header	Type	Required	Description
app-id	string	Yes	Your application ID. Required for authentication.
Authorization	string	Yes	Your API key. for authorization. Required for authentication.
Content-Type	string	Yes	Must be set to application/json.

---

Attributes

---

hotelid alphanumeric (Required)

Specifies the required node hotelid containing the IT provider's hotel ID for which the provider wishes to add mapping information.

---

channelhotelid alphanumeric (Required)

Specifies the unique hotel ID used in the external distribution channel or PMS (Property Management System).

---

listingid numeric (Required)

Listing ID of the property allocated by Airbnb.

---

images array of objects (Required)

Array containing image details to be uploaded.

---

caption string (Optional)

Caption for the image.

---

sort_order numeric (Optional)

Order of the image.

---

image string (Required)

URL of the image.

---

imageid string (Optional)

Unique identifier from the image API (su_imageid).

---

pms_imageid string (Optional)

PMS-assigned image ID (must exist in the SU system).

Note: At least one of image, imageid, or pms_imageid must be provided.

---

category enum (Required)

Short description of the photo. Allowed values: LISTING, ROOM, LISTING_AMENITY, ROOM_AMENITY.

---

facility_id numeric (Required only if category is LISTING_AMENITY or ROOM_AMENITY)

ID of the facility for which the image is uploaded.

---

room_id numeric (Required only if category is ROOM or ROOM_AMENITY)

ID of the Airbnb room for which the image is uploaded.

---

Request

{ 

    "hotelid": "SUTEST01",

    "channelhotelid" : "511039958", 

    "listingid" : "1541919118065328804", 

    "images" : [ 

        { 

            "caption": "Pool Side View", 

            "sort_order": 1, 

            "image": "https://static.otaswitch.com/images/e1242785d4035a52d4e2511167e2a8ef.jpg", 

            "category": "ROOM_AMENITY, 

            "facility_id": "312", 

            "room_id": "746982076" 

        }, 

        { 

            "caption": "Balcony View", 

            "sort_order": 2, 

            "image_id": 11958, 

            "category": "LISTING_AMENITY, 

            " facility_id": "313" 

        }, 

        { 

            "caption": "Guest Room", 

            "sort_order": 3, 

            "pms_imageid": 1182, 

            "category": "LISTING 

        } 

    ] 

} 

---

Response

---

Success Response

{ 

    "Status": "Success", 

    "Data": [ 

        { 

            "airbnb_photo_id": "1541919118065328804_2414384950", 

            "message": "uploaded" 

        }, 

        { 

            "airbnb_photo_id": "1541919118065328804_2414384894", 

            "message": "uploaded" 

        }, 

        { 

            "airbnb_photo_id": "1541919118065328804_2414384984", 

            "message": "uploaded" 

        } 

    ], 

    "Message": "Photos created successfully" 

} 

---

Success Response - Body Elements

Status string

Indicates the result of the API call. Will be "Success" if the photos are created successfully.

---

Data array of objects

Contains details of each uploaded photo. Each object includes:

---

airbnb_photo_id string

The Airbnb-assigned ID of the uploaded photo.

---

message string

Status message indicating the photo was uploaded.

---

Message string

Response message indicating the overall result of the photo creation operation.

---

Error Response

Error 1

{
  "Status": "Fail",
  "Errors": [
    {
      "Code": "1186",
      "ShortText": "amenity is required in images when category is ROOM_AMENITY or LISTING_AMENITY"
    }
  ]
}

---

Error Response - Body Elements

Status string

Indicates the result of the API call.

Will be always "Fail" in case of an error response.

---

Errors object

The response error, the root element.

---

Code string

Specific error code that helps identify the type of error.

For example: "400" indicates a bad request.

---

ShortText string

A short description of the error.

---

Message string

The message in the response.