Set Up Event Giveaway

Call this API method to set up the giveaway for an event. To edit an existing giveaway option, include the giveaway_option_id field with the giveaway option information. Any existing giveaway option not in the request will be deleted. The order that the giveaway options appear here will be the order they are displayed to users. The response includes the giveaway options ids in the order defined. If there are no giveaway options provided, giveaways will be disabled.

For JSON requests, the request should look like the example below.

{
	"giveaway": "Text of give-away shown to user.  E.g. \"T-Shirt\"",
	"giveaway_cutoff_date": "2014-12-31",
	"giveaway_options": [
		{
			"giveaway_option_id": 12345,
			"giveaway_option_text": "None",
			"additional_cost_in_cents": -200
		},
		{
			"giveaway_option_id": 12346,
			"giveaway_option_text": "Small",
			"additional_cost_in_cents": 0
		},
		{
			"giveaway_option_id": 12347,
			"giveaway_option_text": "Medium",
			"additional_cost_in_cents": 0
		},
		{
			"giveaway_option_id": 12348,
			"giveaway_option_text": "Large",
			"additional_cost_in_cents": 0
		},
		{
			"giveaway_option_id": 12349,
			"giveaway_option_text": "XLarge",
			"additional_cost_in_cents": 500
		}
	]
}

For XML requests, the request should look like the example below.

<giveaway_settings>
  <giveaway>Text of give-away shown to user.  E.g. "T-Shirt"</giveaway>
	<giveaway_cutoff_date>2014-12-31</giveaway_cutoff_date>
	<giveaway_options>
		<giveaway_option>
			<giveaway_option_id>12345</giveaway_option_id>
			<giveaway_option_text>None</giveaway_option_text>
			<additional_cost_in_cents>-200</additional_cost_in_cents>
		</giveaway_option>
		<giveaway_option>
			<giveaway_option_id>12346</giveaway_option_id>
			<giveaway_option_text>Small</giveaway_option_text>
			<additional_cost_in_cents>0</additional_cost_in_cents>
		</giveaway_option>
		<giveaway_option>
			<giveaway_option_id>12347</giveaway_option_id>
			<giveaway_option_text>Medium</giveaway_option_text>
			<additional_cost_in_cents>0</additional_cost_in_cents>
		</giveaway_option>
		<giveaway_option>
			<giveaway_option_id>12348</giveaway_option_id>
			<giveaway_option_text>Large</giveaway_option_text>
			<additional_cost_in_cents>0</additional_cost_in_cents>
		</giveaway_option>
		<giveaway_option>
			<giveaway_option_id>12349</giveaway_option_id>
			<giveaway_option_text>XLarge</giveaway_option_text>
			<additional_cost_in_cents>500</additional_cost_in_cents>
		</giveaway_option>
  </giveaway_options>
</giveaway_settings>

URL

HTTP Method

Standard Parameters

Parameters