/membervariables/{id}

Returns a single Member Variable item based on the unique identifier for the item in a Single Choice, Multiple Choice, or Open End question.

Resource URL

/v1/applications/{communityApiKeyName}/membervariables/{id}

Note:

Use the appropriate regional endpoint to ensure that you comply with your organization's privacy policy, and applicable laws and regulations. For details about the available regional endpoints, and how to identify your organization's region, see API Access.

Available Methods

Method Description
GET Get a specific Member Variable.
PATCH Replace is the only operation available at this time.

Field Descriptions

Field Description
categories The string value for the member variable category. Possible values are profileVariable, systemVariable. or both.
constraints The constraints collection specifies a set of behaviors that the system will implement for a given Member Variable. For the most part, these need not be adjusted from their defaults. For each supported constraint in the collection, a boolean value is recorded.
Property Description
disabled Not implemented
hidden When set to true, the Member Variable will no longer be returned when sending a GET request to the /membervariables resource. However, it will remain accessible by specifying an id using the /membervariables/{id} resource.
readOnly Not implemented
returnLatest When set to true, this indicates that the latest Member Value should always be returned. This is true for System Variables such as email. This behavior can be seen in the /membervalues/asof/{datetime} resource.
uniquePerMember

When this constraint is set to true, the service will ensure that a given Member Variable Value is only ever assigned (including historically) to one member. The purpose of enabling this constraint is for implementing identity such as the email System Variable.

It can also be set for non-System Variables and is helpful when integrating another system that has its own means of uniquely identifying members.

createdBy The GUID for the user who created the record.
createDate The date timestamp (UTC) for when the record was created.
dataType The string value for the value definition (for example, number).

A Member Variable also has a datatype property, which controls the type of storage and retrieval of its Member Variable Values.

A datatype can be:

  • text
  • date
  • numeric
description The string name for the member variable.
href A link that points to specific member variable.
id The GUID for the given member variable.
isCalculatedVariable A boolean value indicating whether the profile variable is a calculated date.
lastUpdatedBy The GUID for the user who last updated the record.
lastUpdateDate The date timestamp (UTC) for when the record was last updated.
links This field is always empty.
memberVariableValues The link that points to the member variable values.
name The string name for the member variable.
referenceMemberVariableId The profile variable referenced by a calculated date profile variable. This field is only returned for calculated dates. The referenced variable must be set with the type: Open and the dataType: Date.
sensitive The boolean value indicating whether or not the variable is eligible to be purged or modified.

You cannot POST a new value to the following sensitive system variables:

  • email
  • firstname
  • lastname
  • name
  • signupemail
  • signupfirstname
  • signuplastname
  • unsubscribereasonother
  • username
sequenceId This is an internal field.
source The string value for the variable type. Possible values are:
  • system
  • profile

This field may also be empty.

type The string value for question type. Possible values are:
  • open: Allows only a single Member Value to be assigned at any time, but indicates an unlimited number of possible values.

    Sample question: "Which city do you live in?"

  • singleChoice:Allows one Member Value to be assigned to a member at any point in time.

    Sample question: "Which city do you live in?"

  • multiChoice: Allows more than one Member Value to be assigned at any point in time.

    Sample question: "Select all the grocery stores you have shopped at from the list."

Note: Both singleChoice and multiChoice indicate a finite list of choices. For example, a list of answer options in a Multiple Choice question.
userCategories A list of all user categories assigned to the member variable.
GET response format 

{
   "id": <GUID for member variable>,
   "name": <member variable name>,
   "description": <member variable description>,
   "source": <system|profile>,
   "type": <singleChoice|multiChoice|open>,
   "dataType": <text|date|numeric>,
   "constraints": {
      "disabled": <true|false>,
      "hidden": <true|false>,
      "readOnly": <true|false>,
      "returnLatest": <true|false>,
      "uniquePerMember": <true|false>
   },
   "categories": [
      <array of profileVariable|systemVariable>
   ],
   "memberVariableValues": {
      "href": <href to member variable values for this member variable>
   },
   "sequenceId": <integer>,
   "sensitive": <true|false>,
   "createDate": <date and time UTC>,
   "lastUpdateDate": <date and time UTC>,
   "createdBy": <GUID of user>,
   "lastUpdatedBy": <GUID of user>,
   "links": [],
   "href": "https://api.{region}.alida.com/v1/applications/{communityApiKeyName}/membervariables/{GUID for member variable}"
}

PATCH Requests

The following fields are read-only:
  • createDate
  • createdBy
  • href
  • id
  • lastUpdateDate
  • lastUpdatedBy
  • memberVariableValues
  • sequenceId

You cannot replace sensitive system variables values:

  • email
  • firstname
  • lastname
  • name
  • signupemail
  • signupfirstname
  • signuplastname
  • unsubscribereasonother
  • username
You can replace the following values in the type field:
Text field value Replace with
open multiChoice
singleChoice
  • open
  • multiChoice
Example: PATCH /membervariables/{id}

[
   {
      "op": "Replace",
      "path": "/constraints/uniquePerMember",
      "value": true
   }
]
Example: PATCH /membervariables/{id} for calculated dates
[
  {
    "op":"Replace",
    "Path":"/referenceMemberVariableId",
    "Value":"3fa85f64-5717-4562-b3fc-2c963f66afa6"
  }
]

System variables

System variable Variable name Description
Email email The member's email address.
First Name firstname The member's first name.
Forum Responder Type forumrespondertype

The member's participation status in a forum.

Possible values are:

  • Active
  • Lurked
  • NeverInvited
  • NonResponder
  • Passive
  • TopPoster
For more information see, Forum participation and Forum statistics.
GCM Device Tokens gcmdevicetokens This field has been deprecated.
Join Date joindate The date on which the member confirmed that they were joining the community.
Join Date joindate The date on which the member confirmed that they were joining the community.
Last Login Date lastlogindate The last date on which a member signed in to the portal.
Last Name lastname The member's last name.
Member Status memberstatus The current status of the member in the system.

Possible values are:

  • Nonmember

    The person is not a member of the community. The person's email address and profile attributesvariables are in the system; however, the person has not been recruited yet.

  • Pending
    A person is marked Pending when one of the following has occurred:
    • The person receives an email invitation to join the community
    • The person clicks the recruitment link in the email without completing the recruitment survey
    • The person completes the recruitment survey without confirming their membership
  • Active

    The person is a member of the community and can be invited to participate in activities.

  • Purged

    The member was purged from the community. You cannot send Purged members invitations or reminders for any activity type.

  • Undeliverable
    A member is marked Undeliverable if the following occurs:
    • Three consecutive hard bounces (email delivery failed because of a server error or because the email address was invalid)
    • Ten consecutive soft bounces (email delivery failed because the member's inbox was full)
    • One spam complaint (email delivered to a Hotmail, AOL, or Yahoo account was marked as spam)

    You cannot send Undeliverable individuals invitations or reminders for activities.

  • Unsubscribed

    The member no longer wants to receive emails from the community and has requested removal from the community. You cannot send Unsubscribed members invitations or reminders for activities.

Name name The name of the member.
Recruitment Communication ID recruitmentcommunicationid The unique ID associated with a recruitment's distribution email or recruitment link.
Recruitment Method recruitmentmethod The method through which a member was recruited.
Possible values are:
  • Unknown: The member's recruitment method is not known.
  • Email: The member was recruited through an email invitation.
  • SurveyLink: The member was recruited through a recruitment link.
Recruitment Source recruitmentsource The member's recruitment source (for example, a recruitment link posted on social media or a CSV upload).
Recruitment Status recruitmentstatus

The member's status in the recruitment process.

Possible values are:
  • ConfirmationSent
  • invitationsent
  • Joined
  • RecruitmentSurveyStarted
  • Unknown
  • UploadedFromCsv
Sign Up Email signupemail The email address the member used to join the community.
Sign Up First Name signupfirstname The member's first name at the time they joined the community.
Sign Up Last Name signuplastname The member's last name at the time they joined the community.
Sign Up Recruitment Stats signuprecruitmentstatus The member's status in the sign up process.

Possible values are:

  • ConfirmationSent
  • invitationsent
  • Joined
  • RecruitmentSurveyStarted
  • Unknown
  • UploadedFromCsv
Survey Responder Type surveyrespondertype

The member's survey participation status.

Possible values are:

  • goodresponder
  • idealresponder
  • NeverInvited
  • NonResponder
  • poorresponder
Unsubscribe Reason unsubscribereason

The reason why a member has requested their removal from the community and unsubscribed themselves.

During the unsubscribe process, the application asks members an optional question about why they are leaving the community. Possible values are:

  • NotSpecified (the member chose not to answer the question)
  • NotRelevant ("The communications were not relevant to me")

  • TooManyCommunications ("Too many communications")

  • NotEnoughCommunication ("Not enough communications")
  • NotAsExpected ("I was expecting something different")
  • ResponseTimeTooShort ("I am not given enough time to respond")
  • NotValued ("I don't feel that my input or opinions are valued")
  • Other (the member has a different reason for leaving the community, as specified for unsubscribereasonother)
Unsubscribe Reason (other) unsubscribereasonother The exact reason why members have requested their removal from the community and unsubscribed themselves, if they chose Other for unsubscribereason.
Upload ID uploadid The unique ID for the CSV upload.
Username username The member's username for the community.