Allows you to add a new Marketplace sale or modify and existing sale
Either create a new Marketplace sale or modify an existing sale. Please remember that use of our API assumes that you agree to all of our terms and conditions, including our Marketplace terms and conditions.
Sample RequestRequest ParametersIf you need more information on any of these fields, we recommend going into your account and selecting to add a domain for sale. The subsequent page will have a more detailed description of each field.
domain: The domain to add or modify
action: Must be "add" or "modify"
sale_type: Must be either "offer_counter_offer" or "auction" (only required when adding)
reserve: The reserve price for the sale
show_reserve: Whether or not to show the reserve price ("1" for yes, "0" or not passed for no)
allow_bids_under_reserve: Whether or not to allow bids for Auctions under the reserve price ("1" for yes, "0" or not passed for no)
buy_now: The buy now (BIN) price for the sale
payment_plan_offered: Whether or not to offer a payment plan to the Buyer ("1" for yes, "0" or not passed for no)
payment_plan_months: The maximum number of months for the payment plan (Any number between 1-12)
payment_plan_down_payment: The minimum required down payment for the payment plan
end_date: The date/time for the sale to end (must be in YYYY-MM-DD HH:MM:SS format)
end_date_use_maximum: Whether or not to have our system apply the maximum possible end date/time ("1" for yes, "0" or not passed for no)
notify_buyers: When adding, pass to notify any Buyers who had previously bid or offered to buy the domain ("1" for yes, "0" or not passed for no)
category1: The ID of the category to add the sale to in our Marketplace ( category IDs )
description: A url-encoded description to be used on the bid/offer page for your sale
use_for_sale_landing_page: When adding, whether or not to use a "For Sale" landing page ("1" for yes, "0" or not passed for no)
mp_use_our_nameservers: When adding and selecting to use a landing page, whether or not to update the domain to use our name servers ("1" for yes, "0" or not passed for no)
password: the passowrd to use if you want to password-protect your sale
cancel_sale: Pass "1" if you want to cancel your sale
<message>Your selected domains have been added to our marketplace!</message>