Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 13 Next »

The Participants resource is one the central resources in the Actionstep system. Many other resources reference it and there are a large number of resources that extend this base resource.

 

Resource Location: /participants

Available Methods: GET POST PUT DELETE OPTIONS

Default Page Size: 50

Max Page Size: 100

Default Includes: None


Resource Atributes
FieldDescriptionFormatRequiredField TypeNotes
displayNameThe participants name formatted as defined by the Display Name Format global preference.stringtruedefault 
isCompanyDefines the participant as either a Company or Individual.booleantruedefault 
companyNameThe name of the company if the participant is a Company, or the name of the employer if the participant is an Individual.stringfalsedefault 
salutationThe Individual's prefix.stringfalsedefault 
firstNameThe Individual's first name.stringfalsedefault 
middleNameThe Individual's middle name.stringfalsedefault 
lastNameThe Individual's last name.stringfalsedefault 
suffixThe Individual's suffix.stringfalsedefault 
preferredNameThe Individual's preferred name.stringfalseadditional 
physicalAddressLine1The primary field for the physical address of the participant.stringfalsedefault 
physicalAddressLine2An optional secondary address field for the physical address.stringfalsedefault 
physicalCityThe city portion of the physical address.stringfalsedefault 
physicalStateProvinceThe state or province portion of the physical address.stringfalsedefault 
physicalPostCodeThe postcode or zip code portion of the physical address.stringfalsedefault 
physicalCountryThe associated countries resource for the country portion of the physical address.stringfalselink 
mailingAddressLine1The primary field for the mailing address of the participant.stringfalseadditional 
mailingAddressLine2An optional secondary address field for the mailing address.stringfalseadditional 
mailingCityThe city portion of the mailing address.stringfalseadditional 
mailingStateProvinceThe state or province portion of the mailing address.stringfalseadditional 
mailingPostCodeThe postcode or zip code portion of the mailing address.stringfalseadditional 
mailingCountryThe associated countries resource for the country portion of the mailing address.stringfalselink 
phone1LabelA description of the primary phone number.stringfalsedefault 
phone1CountryThe country portion of the primary phone number.stringfalsedefault 
phone1AreaThe area code portion of the primary phone number.stringfalsedefault 
phone1NumberThe number portion of the primary phone number.stringfalsedefault 
phone1NotesA notes field for the primary phone number.stringfalsedefault 
phone2LabelA description of the secondary phone number.stringfalseadditional 
phone2CountryThe country portion of the secondary phone number.stringfalseadditional 
phone2AreaThe area code portion of the secondary phone number.stringfalseadditional 
phone2NumberThe number portion of the secondary phone number.stringfalseadditional 
phone2NotesA notes field for the secondary phone number.stringfalseadditional 
phone3LabelA description of the tertiary phone number.stringfalseadditional 
phone3CountryThe country portion of the tertiary phone number.stringfalseadditional 
phone3AreaThe area code portion of the tertiary phone number.stringfalseadditional 
phone3NumberThe number portion of the tertiary phone number.stringfalseadditional 
phone3NotesA notes field for the tertiary phone number.stringfalseadditional 
phone4LabelA description of the quaternary phone number.stringfalseadditional 
phone4CountryThe country portion of the quaternary phone number.stringfalseadditional 
phone4AreaThe area code portion of the quaternary phone number.stringfalseadditional 
phone4NumberThe number portion of the quaternary phone number.stringfalseadditional 
phone4NotesA notes field for the quaternary phone number.stringfalseadditional 
faxThe participant's fax number.stringfalseadditional 
smsThe number to use for SMS.stringfalseadditional 
emailThe participant's email address.stringfalsedefault 
websiteThe participant's web address.stringfalseadditional 
occupationThe participant's occupation.stringfalseadditional 
taxNumberThe tax number.stringfalseadditionalUses the Tax Number Alias on the Base Participant Type.
birthTimestampThe participant's Date of Birth.timestampfalsedefault 
deathTimestampThe participant's Date of Death.timestampfalseadditional 
maritalStatusMarital status.stringfalsedefault 
genderGender.stringtruedefault 
emailFormatThe preferred email format for the participant.stringfalseadditionalText / HTML
notificationMethodThe preferred notification method for the participant.stringfalseadditional 
isNewsletterSubscriberIf the participant is a Newsletter subscriber.booleanfalseadditionalDeprecated?
modifiedTimestampTimestamp when the record was last modified.timestampfalseadditional 
createdTimestampTimestamp when the record was created.timestampfalseadditional 
divisionThe associated divisions resource for the participant.stringtruelink 
billingPreferenceThe associated billingpreference resource of the participant.stringfalselink 

 

Link Templates
IdentifierResourceLocation Template
participants.physicalCountrycountries/countries/{participants.physicalCountry}
participants.mailingCountrycountries/countries/{participants.mailingCountry}
participants.divisiondivisions/divisions/{participants.division}
participants.billingPreferencebillingPreferences/billingPreferences/{participants.billingPreference}

 

Example Requests / Responses
  • GET timerecords
  • POST timerecords
  • PUT timerecords
  • DELETE timerecords
  • No labels