Our v3 API is now available! Learn more by visiting the v3 developer portal.

Individual Event API

Use this API to retrieve (GET), update (PUT), or Publish/Cancel (PATCH) an existing event. To create a new event, use the Events Collection API POST method.

Methods:

Click a method to view its documentation

GET PUT PATCH

DescriptionTOP

Privileges required: contacts:lists:write

PUT: Update the name, status of the ContactList specified by the listId path parameter. Performing a PUT overwrites all existing properties for the contactlist resource; any properties left blank or not included in the call will delete those property values prior to the call.

DescriptionTOP

Privileges required: mylibrary:folder:update

Use PUT to modify the following properties for a folder specified by folderId path parameter:

  • update the folder's name
  • change the folder's location in the directory structure by changing it's parent_id
    To move a folder to level 1 in the directory structure, set the parent_id to 0

DescriptionTOP

Privileges required: mylibrary:file:update

Use a PUT call to update the following for a file (specified using the fileId path parameter):

  • Update the name
  • Update the description
  • Move a file to another folder, using folder_id to specify the destination folder.

DescriptionTOP

Privileges required: campaign:write

Update an existing event by using the eventId path parameter. 

DescriptionTOP

Privileges required: campaign:write

Update an existing event item; specify the event and the item using the eventId and itemId path parameters.

DescriptionTOP

Privileges required: campaign:write

Update an existing promocode for an event; specify the code and event using the eventId and promocodeId path parameters.

DescriptionTOP

Privileges required: campaign:write

Update an existing fee (specify using feeId) for an event specified by eventId.

DescriptionTOP

Privileges required: campaign:write

Update an existing item attribute by specifying the eventId, itemId, and attributeId path parameters. Include the attribute name and description in the JSON request body. 

NOTE: You cannot change an attribute name once any have been sold to or claimed by event registrants.

DescriptionTOP

Privileges required: campaign:activate

Update the schedule for an email campaign using the scheduleId and campaignId path parameters.

DescriptionTOP

Privileges required: campaign:create

Update an existing email campaign message specified by the campaignId path parameter. For campaigns with a template_type = CUSTOM, all editable fields are available for updating. If template_type = STOCK, the following fields are not available for edit (read-only):

  • text_content
  • email_content
  • style_sheet

These fields can only be updated using the Constant Contact user interface.

NOTE: 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.

PUT: https://api.constantcontact.com/v2/eventspot/events/{event_id}

Test API

name

type

default

description

api_key

query

REQUIRED; The API key for the application

eventId

path

Unique ID of the event to update

Example JSON Request BodyTOP

{
    "name": "My Event - October 2013",
    "title": "My Brand New Event",
    "status": "DRAFT",
    "location": "The Atrium on the Wharf",
    "type": "CLASSES_WORKSHOPS",
    "address": {
        "city": "Anytown",
        "state": "Massachusetts",
        "country": "United States",
        "line1": "123 Maple Road",
        "state_code": "MA",
        "country_code": "us",
        "postal_code": "11111"
    },
    "description": "Take your skills to the next level by attending these focused workshops.",
    "contact": {
        "name": "Knowshon Moreno",
        "email_address": "kmoreno@example.com",
        "phone_number": "555-555-5555",
        "organization_name": "The Event Organization"
    },
    "start_date": "2014-08-06T14:00:00.000Z",
    "end_date": "2014-08-08T21:00:00.000Z",
    "time_zone_id": "US/Eastern",
    "is_checkin_available": false,
    "registration_url": "https://events.r20.l1.constantcontact.com/register/event?oeidk=a07e1iw4r2m67314717",
    "theme_name":"Default",
    "payment_address":{
        "city":"My City",
        "line1":"1111 Broadway",
        "state_code":"FL",
        "country_code":"US",
        "postal_code":"11111"
    },
    "paypal_account_email":"jdoe@example.com",
    "payable_to":"The Payee",
    "payment_options":[
        "PAYPAL",
        "CHECK",
        "DOOR"
    ],
    "currency_type": "USD",
    "is_virtual_event": false,
    "notification_options": [
        {
        "notification_type": "SO_REGISTRATION_NOTIFICATION",
        "is_opted_in": true
        }
    ],
    "is_home_page_displayed": false,
    "is_map_displayed": true,
    "is_calendar_displayed": true,
    "is_listed_in_external_directory": false,
    "are_registrants_public": false,
    "track_information": {
        "information_sections": [
            "CONTACT",
            "TIME",
            "LOCATION"
        ],
        "is_registration_closed_manually": false,
        "is_ticketing_link_displayed": false,
        "guest_limit": 0,
        "registration_limit_count": 0,
        "guest_display_label": "Guest(s)",
        "is_guest_name_required": false,
        "is_guest_anonymous_enabled": false
    }
}

Response CodesTOP

code

description

200

Event was successfully updated

400

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

415

Unsupported content-type in the header, must be application/json

500

Internal server error occurred

StructureTOP

property

type(max length)

description

Example ResponseTOP

{
    "id":"a07e1iw4r2m67314717",
    "name":"My Event - October 2013",
    "title":"My Brand New Event",
    "status":"DRAFT",
    "location":"The Atrium on the Wharf",
    "type":"CLASSES_WORKSHOPS",
    "address":{
        "city":"Anytown",
        "state":"Massachusetts",
        "country":"United States",
        "line1":"123 Maple Road",
        "state_code":"MA",
        "country_code":"us",
        "postal_code":"11111"
    },
    "description":"Take your skills to the next level by attending these focused workshops.",
    "contact":{
        "name":"Knowshon Moreno",
        "email_address":"kmoreno@example.com",
        "phone_number":"555-555-5555",
        "organization_name":"The Event Organization"
    },
    "start_date":"2014-08-06T14:00:00.000Z",
    "end_date":"2014-08-08T21:00:00.000Z",
    "created_date":"2013-10-02T18:00:41.644Z",
    "time_zone_id":"US/Eastern",
    "is_checkin_available":false,
    "registration_url":"https://events.r20.l1.constantcontact.com/register/event?oeidk=a07e1iw4r2m67314717",
    "theme_name":"Default",
    "paypal_account_email":"jdoe@example.com",
    "payment_address":{
        "city":"My City",
        "state":"Florida",
        "country":"United States",
        "line1":"1111 Broadway",
        "state_code":"FL",
        "country_code":"us",
        "postal_code":"11111"
    },
    "payable_to":"The Payee",
    "payment_options":[
        "PAYPAL",
        "CHECK",
        "DOOR"
    ],
    "currency_type":"USD",
    "is_virtual_event":false,
    "notification_options":[
        {
        "notification_type":"SO_REGISTRATION_NOTIFICATION",
        "is_opted_in":true
        }
    ],
    "is_home_page_displayed":false,
    "is_map_displayed":true,
    "is_calendar_displayed":true,
    "is_listed_in_external_directory":false,
    "are_registrants_public":false,
    "track_information":{
        "information_sections":[
            "CONTACT",
            "TIME",
            "LOCATION"
        ],
        "is_registration_closed_manually":false,
        "is_ticketing_link_displayed":false,
        "guest_limit":0,
        "registration_limit_count":0,
        "guest_display_label":"Guest(s)",
        "is_guest_name_required":false,
        "is_guest_anonymous_enabled":false
    }
}