Common Models

The following is an example of a Person’s (James W. Gordon) Signup for the Neighbors Calling Neighbors Event. James has been Invited to be the Host during Shift 2452 (specifically from 3PM to 4PM) at Campaign HQ.

{
  "eventSignupId": 2452,
  "person": {
    "vanId": 100476252,
    "firstName": "James",
    "middleName": "Worthington",
    "lastName": "Gordon"
  },
  "event": {
    "eventId": 1370,
    "name": "Neighbors Calling Neighbors",
    "shortName": "NeighborCall"
  },
  "shift": {
    "eventShiftId": 2162,
    "name": null
  },
  "role": {
    "roleId": 111687,
    "name": "Host"
  },
  "status": {
    "statusId": 4,
    "name": "Invited"
  },
  "location": {
    "locationId": 272,
    "name": "Campaign HQ",
    "displayName": "Campaign HQ, 48 Grove St Somerville, MA 02144-2500"
  },
  "startTimeOverride": "2015-06-01T15:00:00-04:00",
  "endTimeOverride": "2015-06-01T16:00:00-04:00"
}

Signup

The overall Signup object has a number of properties with simple object values. Only simple objects’ unique identifiers are required.

PropertyTypeDescription
eventSignupIdintRead-only; Unique identifier for this Signup
personobjectRequired; An accessible Person
eventobjectRequired; A simple Event to sign up for
shiftobjectRequired; A simple Shift of the Event
roleobjectRequired; A simple Role for this person to play
statusobjectRequired; A signup Status (e.g., “Invited”)
locationobjectRequired if event has Locations; If specified, a Location that is available to this Event
startTimeOverridedatetimeOptional; If specified, overrides the startTime of the associated shift and requires that endTimeOverride must also be set
endTimeOverridedatetimeOptional; If specified, overrides the endTime of the associated shift and requires that startTimeOverride must be set to an earlier time
supporterGroupIdintOptional; a Supporter Group to associate with this Event Signup

Person

PropertyTypeDescription
vanIdstringRequired; Unique identifier for an accessible person
firstNamestringRead-only; A person’s first name, no longer than 20 characters
middleNamestringRead-only; A person’s middle name, no longer than 20 characters
lastNamestringRead-only; A person’s last name, no longer than 25 characters

Event

PropertyTypeDescription
eventIdintRequired; Unique identifier for an accessible Event
namestringRead-only; A name for this Event, no longer than 500 characters
shortNamestringRead-only; A shorter name for this Event, no longer than 12 characters

Shift

PropertyTypeDescription
eventShiftIdintRequired; Unique identifier for a Shift of this Event
namestringRead-only; A name for this Shift, no longer than 15 characters

Role

PropertyTypeDescription
roleIdintRequired; Unique identifier for a Role available to this Event
namestringRead-only; The name of this Role, no longer than 50 characters

Status

PropertyTypeDescription
statusIdintRequired; Unique identifier for a Status available to this Event (as specified by the Event Type)
namestringRead-only; The name of this Status, no longer than 10 characters

Location

PropertyTypeDescription
locationIdintRequired; Unique identifier for an existing Location
namestringRead-only; The name of this Location, no longer than 50 characters
displayNamestringRead-only; The name and address of this Location, no longer than 200 characters