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

Events Collection Endpoint

Use this API endpoint to view (GET) all existing events, or create (POST) a new event.

Methods:

Click a method to view its documentation

GET POST

DescriptionTOP

Privileges required: campaign:list

Retrieve all events in a user's account.

GET: https://api.constantcontact.com/v2/eventspot/events

Test API

name

type

default

description

api_key

query

REQUIRED; The API key for the application

limit

query

50

Specifies the number of results displayed per page of output, from 1 - 500, default = 50. See Paginated Output for more information on using limit.

Response CodesTOP

code

description

200

Request was successful

401

Authentication failure

401

The eventId provided does not exist

406

Unsupported Accept Header value, must be application/json

500

Internal server error occurred

Example ResponseTOP

{
    "meta":{
        "pagination":{
        }
    },
    "results":[
        {
        "id":"a07e1iw09oscc73adfe",
        "name":"Sep 30, 2013 - Apps-R-Us Event",
        "title":"My First Event",
        "status":"ACTIVE",
        "location":"The Great Room",
        "type":"CLASSES_WORKSHOPS",
        "address":{
          "city":"AnyCity",
          "state":"Massachusetts",
          "country":"United States",
          "latitude":42.125515,
          "longitude":-71.49862,
          "line1":"123 Maple Street",
          "line2":"",
          "line3":"",
          "state_code":"MA",
          "country_code":"us",
          "postal_code":"99999"
        },
        "description":"Please join our monthly seminar and learn some new skills while meeting new friends, and catching up with old friends.",
        "start_date":"2013-10-28T13:00:00.000Z",
        "end_date":"2013-10-28T21:00:00.000Z",
        "created_date":"2013-09-30T19:29:40.630Z",
        "time_zone_id":"US/Eastern",
        "active_date":"2013-09-30T19:37:44.006Z",
        "is_checkin_available":false,
        "event_detail_url":"/v2/eventspot/events/a07e1iw09oscc73adfe"
        }
    ]
}