Event Item Attribute Collection API Endpoint
Use Item Attributes to provide options for event items, such as sizes for clothing articles, or color or style options. Use the Item Attribute Collection API endpoint to create (POST) a new attribute, or retrieve (GET) all existing attributes for an item.
Methods:
Click a method to view its documentation
Description TOP
Privileges required : campaign:list
Retrieves the email campaigns in a user's account as follows:
- all campaigns in the user's account (no query parameter specified)
-
campaigns with the status specified using the
statusquery parameter; see the parameter table below for status types and definitions -
campaigns modified on or after the date/time specified using the
modified_sincequery parameter. This is useful for syncing email campaigns across applications.
Campaign sort order depends on the campaign status:
| Status | Campaign sort order |
| DRAFT | by the latest modified_date |
| SENT | by the latest last_run_date |
| SCHEDULED | by the next_run_date |
| DELETED | by the latest last_run_date if it was sent, or by the latest modified_date, if it was never sent |
About DELETED campaigns
Deleted campaigns are included in a GET response only when status=DELETED query parameter is used. They are not included in the GET collection by default. You cannot retrieve an individual deleted campaign object using the API.
Description TOP
Privileges required : mylibrary:file:read
Retrieve a list of MyLibrary folders and their properties for the authorized Constant Contact account. MyLibrary supports a folder hierarchy with 3 levels of nesting. Primary, child (2nd level) and grandchild (3rd level) folders all have the same properties associated with them. This endpoint returns an empty results array if there are no folders in the user's account.
Description TOP
Privileges required : mylibrary:file:read
The following options are available when retrieving Library files:
-
Retrieve all files in all folders in the account - do not use any query parameters (except for
api_key) -
Retrieve all files with a specific type - use the
typequery parameter (ALL, IMAGE, or Document) -
Retrieve all files from a specific source - use the
sourcequery parameter -
Retrieve a specific file type from a specific source - use both the
typeandsourcequery parameters
There are many options available for sorting the JSON response using the
sort_by
query parameter.
Description TOP
Privileges required : campaign:read
Retrieve an event item by using the
eventId
and
itemId
path parameters to specify the event and item.
Description TOP
Privileges required : campaign:read
Retrieve a list of all items for an event specified using the
eventId
path parameter.
Description TOP
Privileges required : campaign:read
Get a specific event object (specified by the
event_id
path parameter). Properties with a null value are not returned in the JSON response.
Description TOP
Privileges required : campaign:read
Retrieve detailed information about a specific registrant (specified by
registrantId
) for an event (specified by
eventId
).
Description TOP
Privileges required : campaign:read
Retrieve the collection of all registrants for the event specified using the
event_id
path parameter.
Description TOP
Privileges required : campaign:read
Retrieve a specific promotional code for an event; use the
promocodeId
and
eventId
path parameters to specify the code and the event it belongs to.
Description TOP
Privileges required : campaign:read
Retrieve all promocodes for an event specified by the
eventId
path parameter.
|
GET: https://api.constantcontact.com/v2/eventspot/events/{eventId}/items/{itemId}/attributes |
|||
|
name |
type |
default |
description |
|---|---|---|---|
|
api_key |
query |
|
REQUIRED; The API key for the application |
|
eventId |
path |
|
Unique ID of the event for which to retrieve item attributes |
|
itemId |
path |
|
Unique ID of the item to which the attributes belong |
Response Codes TOP
|
code |
description |
|---|---|
|
200 |
Request was successful |
|
401 |
Authentication failure |
|
404 |
An event or item could not be found for the ID provided |
|
406 |
Unsupported Accept Header value, must be application/json |
|
500 |
Internal server error occurred |
Structure TOP
|
property |
type (max length) |
description |
|---|
Example Response TOP
[
{
"id":"9k7uXp6Hgyiq7BCC11zFc0XQU2aR_wPmDNJVddPgGWM",
"name":"Royal Blue",
"quantity_total":175,
"quantity_available":175
},
{
"id":"9k7uXp6Hgyiq7BCC11zFc476STDHQ_sadfwfRCYGMSU",
"name":"Hi-Vis Green",
"quantity_total":75,
"quantity_available":75
}
]