POST api/Members

Creates a new member and adds it to a referral program.

Request Information

URI Parameters

Query String: shouldSendEmail={shouldSendEmail}

NameDescriptionTypeAdditional information
shouldSendEmail

Set the value to true if the member should get the program's registration email. Optional.

boolean

Default value is False

Body Parameters

A structure containing information about the member to add to a referral program.

Type: NewMember

NameDescriptionTypeAdditional information
programId

The ID of the referral program to which the member will be added.

string

None.

firstName

string

None.

lastName

string

None.

email

string

None.

referralCode

string

None.

phone

Phone

string

None.

externalIdentifier

An alternative ID provided to help link the member to relevant data in external systems.

string

None.

dateOfBirth

date

None.

addressLine1

string

None.

addressLine2

string

None.

city

string

None.

countrySubdivision

A subdivision of a country, such as a state or province.

string

None.

country

string

None.

postalCode

string

None.

password

string

None.

disabledFlag

This flag is set if the member is NOT enabled for use in referral programs.

boolean

None.

payoutInfo

MemberPayoutInfo

None.

customOption1Name

Custom Option 1 Name

string

None.

customOption1Value

Custom Option 1 Value

string

None.

customText1Name

Custom Text 1 Name

string

None.

customText1Value

Custom Text 1 Value

string

None.

customText2Name

Custom Text 2 Name

string

None.

customText2Value

Custom Text 2 Value

string

None.

Request Formats

application/json, text/json

Sample:
{
  "programId": "sample string 1",
  "firstName": "sample string 2",
  "lastName": "sample string 3",
  "email": "sample string 4",
  "referralCode": "sample string 5",
  "phone": "sample string 6",
  "externalIdentifier": "sample string 7",
  "dateOfBirth": "2018-01-23T08:15:12.1916942Z",
  "addressLine1": "sample string 8",
  "addressLine2": "sample string 9",
  "city": "sample string 10",
  "countrySubdivision": "sample string 11",
  "country": "sample string 12",
  "postalCode": "sample string 13",
  "password": "sample string 14",
  "disabledFlag": true,
  "payoutInfo": {
    "payoutType": "sample string 1",
    "useDefaultValues": true,
    "email": "sample string 3"
  },
  "customOption1Name": "sample string 15",
  "customOption1Value": "sample string 16",
  "customText1Name": "sample string 17",
  "customText1Value": "sample string 18",
  "customText2Name": "sample string 19",
  "customText2Value": "sample string 20"
}

application/xml, text/xml

Sample:
<newMember xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <addressLine1>sample string 8</addressLine1>
  <addressLine2>sample string 9</addressLine2>
  <city>sample string 10</city>
  <country>sample string 12</country>
  <countrySubdivision>sample string 11</countrySubdivision>
  <customOption1Name>sample string 15</customOption1Name>
  <customOption1Value>sample string 16</customOption1Value>
  <customText1Name>sample string 17</customText1Name>
  <customText1Value>sample string 18</customText1Value>
  <customText2Name>sample string 19</customText2Name>
  <customText2Value>sample string 20</customText2Value>
  <dateOfBirth>2018-01-23T03:15:12.1916942-05:00</dateOfBirth>
  <disabledFlag>true</disabledFlag>
  <email>sample string 4</email>
  <externalIdentifier>sample string 7</externalIdentifier>
  <firstName>sample string 2</firstName>
  <lastName>sample string 3</lastName>
  <password>sample string 14</password>
  <payoutInfo>
    <email>sample string 3</email>
    <payoutType>sample string 1</payoutType>
    <useDefaultValues>true</useDefaultValues>
  </payoutInfo>
  <phone>sample string 6</phone>
  <postalCode>sample string 13</postalCode>
  <referralCode>sample string 5</referralCode>
  <programId>sample string 1</programId>
</newMember>

Response Information

Resource Description

[HTTP Status 201 - Created]

Type: MemberConfirmation

NameDescriptionTypeAdditional information
member

Structure containing details about the member.

Member

None.

message

The message provides more information about the results of the client's request. Review this field for error information.

string

None.

Response Formats

application/json, text/json

Sample:
{
  "message": "sample string 1",
  "member": {
    "id": "71f6c66d-724d-4ed6-87de-94b85de2ebf6",
    "firstName": "sample string 2",
    "lastName": "sample string 3",
    "email": "sample string 4",
    "phone": "sample string 5",
    "externalIdentifier": "sample string 6",
    "dateOfBirth": "2018-01-23T08:15:12.1996949Z",
    "addressLine1": "sample string 7",
    "addressLine2": "sample string 8",
    "city": "sample string 9",
    "countrySubdivision": "sample string 10",
    "country": "sample string 11",
    "postalCode": "sample string 12",
    "disabledFlag": true,
    "payoutInfo": {
      "payoutType": "sample string 1",
      "useDefaultValues": true,
      "email": "sample string 3"
    },
    "customOption1Name": "sample string 13",
    "customOption1Value": "sample string 14",
    "customText1Name": "sample string 15",
    "customText1Value": "sample string 16",
    "customText2Name": "sample string 17",
    "customText2Value": "sample string 18",
    "programId": "9fb88260-40c7-4271-b462-689e16607dc8",
    "programTitle": "sample string 20",
    "programName": "sample string 21",
    "referralCode": "sample string 22",
    "referralUrl": "sample string 23",
    "memberUrl": "sample string 24",
    "emailShares": 25,
    "socialShares": 26,
    "views": 27,
    "referrals": 28,
    "lastShare": "2018-01-23T08:15:12.1996949Z",
    "referralsApproved": 29,
    "referralsQualified": 30,
    "referralsApprovedAmount": 31.0,
    "rewardsPendingAmount": 32.0,
    "rewardsIssuedAmount": 33.0,
    "createDt": "2018-01-23T08:15:12.1996949Z"
  }
}

application/xml, text/xml

Sample:
<memberConfirmation xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <message>sample string 1</message>
  <member>
    <id>71f6c66d-724d-4ed6-87de-94b85de2ebf6</id>
    <firstName>sample string 2</firstName>
    <lastName>sample string 3</lastName>
    <email>sample string 4</email>
    <phone>sample string 5</phone>
    <externalIdentifier>sample string 6</externalIdentifier>
    <dateOfBirth>2018-01-23T03:15:12.1996949-05:00</dateOfBirth>
    <addressLine1>sample string 7</addressLine1>
    <addressLine2>sample string 8</addressLine2>
    <city>sample string 9</city>
    <countrySubdivision>sample string 10</countrySubdivision>
    <country>sample string 11</country>
    <postalCode>sample string 12</postalCode>
    <disabledFlag>true</disabledFlag>
    <payoutInfo>
      <email>sample string 3</email>
      <payoutType>sample string 1</payoutType>
      <useDefaultValues>true</useDefaultValues>
    </payoutInfo>
    <customOption1Name>sample string 13</customOption1Name>
    <customOption1Value>sample string 14</customOption1Value>
    <customText1Name>sample string 15</customText1Name>
    <customText1Value>sample string 16</customText1Value>
    <customText2Name>sample string 17</customText2Name>
    <customText2Value>sample string 18</customText2Value>
    <programId>9fb88260-40c7-4271-b462-689e16607dc8</programId>
    <programTitle>sample string 20</programTitle>
    <programName>sample string 21</programName>
    <referralCode>sample string 22</referralCode>
    <referralUrl>sample string 23</referralUrl>
    <memberUrl>sample string 24</memberUrl>
    <emailShares>25</emailShares>
    <socialShares>26</socialShares>
    <views>27</views>
    <referrals>28</referrals>
    <lastShare>2018-01-23T03:15:12.1996949-05:00</lastShare>
    <referralsApproved>29</referralsApproved>
    <referralsQualified>30</referralsQualified>
    <referralsApprovedAmount>31</referralsApprovedAmount>
    <rewardsPendingAmount>32</rewardsPendingAmount>
    <rewardsIssuedAmount>33</rewardsIssuedAmount>
    <createDt>2018-01-23T03:15:12.1996949-05:00</createDt>
  </member>
</memberConfirmation>