action reverb_post_listings {
  label: "Create a listing"
  description: "Create a listing"
  provider: reverb
  method: POST
  path: "/listings"
  encoding: json
  input: {
    type: "object"
    properties: {
      categories: {
        type: "array"
        items: {
          type: "object"
          properties: {
            uuid: {
              type: "string"
              description: "UUID of the category for this listing."
            }
          }
        }
      }
      condition: {
        type: "object"
        description: "Condition"
        required: ["uuid"]
        properties: {
          uuid: {
            type: "string"
            description: "Condition UUID"
            enum: ["fbf35668-96a0-4baa-bcde-ab18d6b1b329", "6a9dfcad-600b-46c8-9e08-ce6e5057921e", "98777886-76d0-44c8-865e-bb40e669e934", "f7a3f48c-972a-44c6-b01a-0cd27488d3f6", "ae4d9114-1bd7-4ec5-a4ba-6653af5ac84d", "df268ad1-c462-4ba6-b6db-e007e23922ea", "ac5b9c1e-dc78-466d-b0b3-7cf712967a48", "6db7df88-293b-4017-a1c1-cdb5e599fa1a", "9225283f-60c2-4413-ad18-1f5eba7a856f", "7c3f45de-2ae0-4c81-8400-fdb6b1d74890"]
          }
        }
      }
      description: {
        type: "string"
        description: "Product description. Please keep formatting to a minimum."
      }
      exclusive_channel: {
        type: "string"
        description: "Currently for users of seller sites only, this allows you to have a listing available only to your seller site by setting this to 'seller_site'"
        enum: ["seller_site", "reverb", "none"]
      }
      finish: {
        type: "string"
        description: "Finish, e.g. 'Sunburst'"
      }
      has_inventory: {
        type: "boolean"
        description: "Set true if selling more than one"
      }
      inventory: {
        type: "integer"
        description: "Number of items available for sale. Reverb will increment and decrement automatically."
      }
      location: {
        type: "object"
        properties: {
          country_code: {
            type: "string"
            description: "Ex: US"
          }
          locality: {
            type: "string"
            description: "Ex: Chicago"
          }
          region: {
            type: "string"
            description: "Ex: IL"
          }
        }
      }
      make: {
        type: "string"
        description: "ex: Fender, Gibson"
      }
      model: {
        type: "string"
        description: "ex: Stratocaster, SG"
      }
      multi_item: {
        type: "boolean"
        description: "Specifies if the listing is a bundle of multiple individual items"
      }
      offers_enabled: {
        type: "boolean"
        description: "Whether the listing accepts negotiated offers (default: true)"
      }
      origin_country_code: {
        type: "string"
        description: "Country of origin/manufacture, ISO code (e.g: US)"
      }
      photos: {
        type: "array"
        description: "An array of image URLs. Ex: ['http://my.site.com/image.jpg']"
        items: {
          type: "string"
        }
      }
      preorder_info: {
        type: "object"
        description: "Create or update a preorder listing. Requires opt-in. Please contact sales@reverb.com if you would like to activate this feature."
        required: ["lead_time_unit"]
        properties: {
          lead_time: {
            type: "integer"
            description: "The amount of time before the item will be ready to ship. When lead_time is submitted it is converted into days and added to the current date to produce `estimated_ship_date` in the response body of the request."
          }
          lead_time_unit: {
            type: "string"
            description: "The unit of time which lead_time is measured in"
            enum: ["days", "weeks"]
          }
          ship_date: {
            type: "string"
            description: "The date the item will be available to ship. In the response body of the request, `estimated_ship_date`, will be the same as ship_date. Date must be ISO8601 format - e.g: 2015-04-09T10:52:23-00:00."
          }
        }
      }
      price: {
        type: "object"
        required: ["amount", "currency"]
        properties: {
          amount: {
            type: "string"
            description: "The amount of money being expressed, as a POSIX-compliant decimal number"
          }
          currency: {
            type: "string"
            description: "The currency the money will be expressed in"
            enum: ["USD", "CAD", "EUR", "GBP", "AUD", "JPY", "NZD", "MXN"]
          }
        }
      }
      prop_65_warning: {
        type: "string"
        description: "If your listing contains chemicals that are required to be reported under California Prop 65, please provide your warning statement. We will add the required 'Warning' label and link to California's information page, so you only need to provide the body of the warning. For more information, see https://www.p65warnings.ca.gov/new-proposition-65-warnings"
      }
      publish: {
        type: "boolean"
        description: "Publish your listing if draft"
      }
      seller: {
        type: "object"
        properties: {
          paypal_email: {
            type: "string"
          }
        }
      }
      seller_cost: {
        type: "string"
        description: "Cost of goods in your currency as a POSIX-compliant decimal number (internal use only, not shown to buyers)"
      }
      shipping: {
        type: "object"
        properties: {
          local: {
            type: "boolean"
            description: "True if you offer local pickup"
          }
          rates: {
            type: "array"
            description: "List of shipping rates. Set to null to clear rates."
            items: {
              type: "object"
              properties: {
                rate: {
                  type: "object"
                  required: ["amount", "currency"]
                  properties: {
                    amount: {
                      type: "string"
                      description: "The amount of money being expressed, as a POSIX-compliant decimal number"
                    }
                    currency: {
                      type: "string"
                      description: "The currency the money will be expressed in"
                      enum: ["USD", "CAD", "EUR", "GBP", "AUD", "JPY", "NZD", "MXN"]
                    }
                  }
                }
                region_code: {
                  type: "string"
                  description: "Country code or subregion/superregion code. Full list of codes at /api/shipping/regions"
                }
              }
            }
          }
        }
      }
      shipping_profile_id: {
        type: "string"
        description: "id of a shop's shipping profile"
      }
      shipping_profile_name: {
        type: "string"
        description: "DEPRECATED, please use shipping_profile_id. Name of a shipping profile"
      }
      sku: {
        type: "string"
        description: "Unique identifier for product"
      }
      sold_as_is: {
        type: "boolean"
        description: "This item is sold As-Is and cannot be returned"
      }
      storage_location: {
        type: "string"
        description: "Internal note used by sellers to back reference their catalog system when entering a listing"
      }
      tax_exempt: {
        type: "boolean"
        description: "Listing is exempt from taxes / VAT"
      }
      title: {
        type: "string"
        description: "Title of your listing"
      }
      upc: {
        type: "string"
        description: "Valid UPC code"
      }
      upc_does_not_apply: {
        type: "boolean"
        description: "True if a brand new product has no UPC code, ie for a handmade or custom item"
      }
      videos: {
        type: "array"
        description: "List of YouTube video urls. Note: ONLY ONE ALLOWED"
        items: {
          type: "object"
          required: ["link"]
          properties: {
            link: {
              type: "string"
              description: "Valid YouTube url"
            }
          }
        }
      }
      year: {
        type: "string"
        description: "Supports many formats. Ex: 1979, mid-70s, late 90s"
      }
    }
  }
  output: {
    type: "object"
    additionalProperties: true
  }
}