Event Items are products that are associated with an event that may be for sale or available at no cost. They are listed on an event registration page so that registrants can access them during the registration process. Use this API endpoint to create (POST) a new item and retrieve (GET) all existing items associated with an event.
Click a method to view its documentation
Privileges required: campaign:write
Create a new event using a properly formatted JSON request payload, as shown in the Example JSON Request Body.
Privileges required: mylibrary:folder:create
Create a new MyLibrary folder by providing the name of the folder and the id of the parent folder if the new folder is to be a child folder (nested in another folder) in the JSON request body. See the example JSON request in the following sections.
Privileges required: campaign:write
Create a new item for an event specified using the eventId
path parameter. To create an item, include the following items in the JSON request body:
name
- each item for an event must have a unique name, with mininum length of 1 characterprice
- if an item is available at no cost to registrants and guest, set = 0.00default_quantity_total
- starting quantity of this item available to registrants and guestsper_registrant_limit
- maximum quantity available to each registrant or guestshow_quantity_available
- use this setting to display, or not, the remaining quantity available on the registration page.Optionally you can include a description of the item in the request body as well.
After you create an item, you can then add attributes to it, such as sizes, colors, just to name a few, using the Item Attribute Collection endpoint.
Privileges required: campaign:write
Create a promotional code for an existing event (specified using eventId
). Promotional codes can be:
Privileges required: campaign:write
Create a new fee for the event specified using the eventId
path parameter.
Privileges required: campaign:write
Create a new attribute for an event item; specify the event and item using the eventId
and itemId
path parameters. To create an attribute, include the attribute name
and quantity_total
(minimum = 0) in the JSON request body. Each attribute for an item must have a unique name with a minimum length of 1 character.
Privileges required: campaign:activate
Schedule an email campaign specified by the campaignId
path parameter to run and be sent out. Define the date and time that the email campaign will be submitted to the send queue (in ISO 8601 format) using the scheduled_date
property. You can create a schedule only for an email campaign in DRAFT or SENT status.
When scheduling a campaign, please provide a lead time of at least 20 minutes; otherwise, you may receive an invalid schedule error response.
NOTE: The account must be in good standing to be able to schedule and send an email campaign.
To send a campaign "now", only include {} in the JSON request payload. When using the Send Now function, the response body will show the time that the scheduling request was made, not the time the email campaign will be sent. Send Now puts the campaign into the queue for the next send window, which occur on a regular basis, generally every 5 minutes.
You can resend an existing campaign that has a SENT status using this endpoint. The campaign will only be sent to contacts that have been added to the contact lists since the last time the campaign was sent (based on the last_run_date
value)
Privileges required: campaign:create
When creating a new email campaign, template_type
is automatically set to CUSTOM; There are several campaign properties that are optional by default, but become REQUIRED once another property is used. See Structure table below for specific properties.
POST: https://api.constantcontact.com/v2/eventspot/events/{eventId}/items |
|||
name |
type |
default |
description |
---|---|---|---|
api_key |
query |
REQUIRED; The API key for the application |
|
eventId |
path |
Unique ID of the event for which to create the item |
{ "name": "Golf Shirt w/logo", "description":"Underarmour moisture wicking material", "price":32.0, "per_registrant_limit": 2, "show_quantity_available": false, "default_quantity_total": 300 }
code |
description |
---|---|
201 |
Item was successfully created |
400 |
Bad Request: Either JSON was malformed or there was a data validation error |
401 |
Authentication failure |
404 |
An event with specified ID not found |
406 |
Unsupported accept header value, must be application/json |
409 |
Item name already in use |
415 |
Unsupported content-type in the header, use application/json |
500 |
Internal server error occurred |
property |
type(max length) |
description |
---|
{ "id":"9k7uXp6Hgyiq7BCC11zFc7IwqpZ7nzW2Y09fUs00t3Q", "name":"Golf Shirt w/logo", "description":"Underarmour moisture wicking material", "price":32.0, "attributes":[ ], "per_registrant_limit":2, "show_quantity_available":false, "default_quantity_total":300, "default_quantity_available":300 }