POST api/rewards

Creates new rewards members and referrals of a referral program.

Request Information

URI Parameters

Query String:

None.

Body Parameters

A list of required structures containing the details about the reward to create.

Type: Collection of NewRewardInfo

NameDescriptionTypeAdditional information
memberQuery

A structure containing details to identify a member to reward.

MemberQuery

None.

referralQuery

A structure containing details to identify a referral to reward.

ReferralQuery

None.

newReward

Details about a reward to create. Required.

NewReward

Required

Request Formats

application/json, text/json

Sample:
[
  {
    "memberQuery": {
      "primaryInfo": {
        "memberId": "sample string 1",
        "referralCode": "sample string 2"
      },
      "secondaryInfo": {
        "externalIdentifier": "sample string 1",
        "email": "sample string 2"
      },
      "tertiaryInfo": {
        "programId": "sample string 1",
        "programName": "sample string 2",
        "programTitle": "sample string 3"
      }
    },
    "referralQuery": {
      "primaryInfo": {
        "referralId": "sample string 1"
      },
      "secondaryInfo": {
        "externalIdentifier": "sample string 1",
        "email": "sample string 2",
        "phoneNumber": "sample string 3"
      },
      "tertiaryInfo": {
        "ProgramId": "sample string 1",
        "ProgramName": "sample string 2",
        "ProgramTitle": "sample string 3"
      },
      "fuzzyInfo": {
        "Identifier": "sample string 1"
      }
    },
    "newReward": {
      "amount": 1.0,
      "payoutId": "sample string 2",
      "eligibilityDate": "2024-03-29T12:53:13.2200049Z",
      "description": "sample string 3"
    }
  },
  {
    "memberQuery": {
      "primaryInfo": {
        "memberId": "sample string 1",
        "referralCode": "sample string 2"
      },
      "secondaryInfo": {
        "externalIdentifier": "sample string 1",
        "email": "sample string 2"
      },
      "tertiaryInfo": {
        "programId": "sample string 1",
        "programName": "sample string 2",
        "programTitle": "sample string 3"
      }
    },
    "referralQuery": {
      "primaryInfo": {
        "referralId": "sample string 1"
      },
      "secondaryInfo": {
        "externalIdentifier": "sample string 1",
        "email": "sample string 2",
        "phoneNumber": "sample string 3"
      },
      "tertiaryInfo": {
        "ProgramId": "sample string 1",
        "ProgramName": "sample string 2",
        "ProgramTitle": "sample string 3"
      },
      "fuzzyInfo": {
        "Identifier": "sample string 1"
      }
    },
    "newReward": {
      "amount": 1.0,
      "payoutId": "sample string 2",
      "eligibilityDate": "2024-03-29T12:53:13.2200049Z",
      "description": "sample string 3"
    }
  }
]

application/xml, text/xml

Sample:
<ArrayOfnewRewardInfo xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <newRewardInfo>
    <memberQuery>
      <primaryInfo>
        <memberId>sample string 1</memberId>
        <referralCode>sample string 2</referralCode>
      </primaryInfo>
      <secondaryInfo>
        <email>sample string 2</email>
        <externalIdentifier>sample string 1</externalIdentifier>
      </secondaryInfo>
      <tertiaryInfo>
        <programId>sample string 1</programId>
        <programName>sample string 2</programName>
        <programTitle>sample string 3</programTitle>
      </tertiaryInfo>
    </memberQuery>
    <referralQuery>
      <fuzzyInfo xmlns:d4p1="http://schemas.datacontract.org/2004/07/ReferralRock.Api.Models">
        <d4p1:Identifier>sample string 1</d4p1:Identifier>
      </fuzzyInfo>
      <primaryInfo>
        <referralId>sample string 1</referralId>
      </primaryInfo>
      <secondaryInfo>
        <email>sample string 2</email>
        <externalIdentifier>sample string 1</externalIdentifier>
        <phoneNumber>sample string 3</phoneNumber>
      </secondaryInfo>
      <tertiaryInfo xmlns:d4p1="http://schemas.datacontract.org/2004/07/ReferralRock.Api.Models">
        <d4p1:ProgramId>sample string 1</d4p1:ProgramId>
        <d4p1:ProgramName>sample string 2</d4p1:ProgramName>
        <d4p1:ProgramTitle>sample string 3</d4p1:ProgramTitle>
      </tertiaryInfo>
    </referralQuery>
    <newReward>
      <payoutId>sample string 2</payoutId>
      <eligibilityDate>2024-03-29T12:53:13.2200049+00:00</eligibilityDate>
      <description>sample string 3</description>
      <amount>1</amount>
    </newReward>
  </newRewardInfo>
  <newRewardInfo>
    <memberQuery>
      <primaryInfo>
        <memberId>sample string 1</memberId>
        <referralCode>sample string 2</referralCode>
      </primaryInfo>
      <secondaryInfo>
        <email>sample string 2</email>
        <externalIdentifier>sample string 1</externalIdentifier>
      </secondaryInfo>
      <tertiaryInfo>
        <programId>sample string 1</programId>
        <programName>sample string 2</programName>
        <programTitle>sample string 3</programTitle>
      </tertiaryInfo>
    </memberQuery>
    <referralQuery>
      <fuzzyInfo xmlns:d4p1="http://schemas.datacontract.org/2004/07/ReferralRock.Api.Models">
        <d4p1:Identifier>sample string 1</d4p1:Identifier>
      </fuzzyInfo>
      <primaryInfo>
        <referralId>sample string 1</referralId>
      </primaryInfo>
      <secondaryInfo>
        <email>sample string 2</email>
        <externalIdentifier>sample string 1</externalIdentifier>
        <phoneNumber>sample string 3</phoneNumber>
      </secondaryInfo>
      <tertiaryInfo xmlns:d4p1="http://schemas.datacontract.org/2004/07/ReferralRock.Api.Models">
        <d4p1:ProgramId>sample string 1</d4p1:ProgramId>
        <d4p1:ProgramName>sample string 2</d4p1:ProgramName>
        <d4p1:ProgramTitle>sample string 3</d4p1:ProgramTitle>
      </tertiaryInfo>
    </referralQuery>
    <newReward>
      <payoutId>sample string 2</payoutId>
      <eligibilityDate>2024-03-29T12:53:13.2200049+00:00</eligibilityDate>
      <description>sample string 3</description>
      <amount>1</amount>
    </newReward>
  </newRewardInfo>
</ArrayOfnewRewardInfo>

Response Information

Resource Description

[HTTP Status 200 - OK]

Type: Collection of NewRewardResult

NameDescriptionTypeAdditional information
memberQuery

Echos the member query sent in the request.

MemberQuery

None.

referralQuery

Echos the referral query sent in the request.

ReferralQuery

None.

reward

Details about a reward to created.

Reward

None.

resultInfo

Details about the results of the request.

ResultInfo

None.

Response Formats

application/json, text/json

Sample:
[
  {
    "memberQuery": {
      "primaryInfo": {
        "memberId": "sample string 1",
        "referralCode": "sample string 2"
      },
      "secondaryInfo": {
        "externalIdentifier": "sample string 1",
        "email": "sample string 2"
      },
      "tertiaryInfo": {
        "programId": "sample string 1",
        "programName": "sample string 2",
        "programTitle": "sample string 3"
      }
    },
    "referralQuery": {
      "primaryInfo": {
        "referralId": "sample string 1"
      },
      "secondaryInfo": {
        "externalIdentifier": "sample string 1",
        "email": "sample string 2",
        "phoneNumber": "sample string 3"
      },
      "tertiaryInfo": {
        "ProgramId": "sample string 1",
        "ProgramName": "sample string 2",
        "ProgramTitle": "sample string 3"
      },
      "fuzzyInfo": {
        "Identifier": "sample string 1"
      }
    },
    "reward": {
      "id": "0217731e-7154-4c8c-a4cd-87aa35282e82",
      "payoutId": "05dde946-6b7b-448e-bf34-b657efd1b84e",
      "payoutDescription": "sample string 3",
      "programId": "c2c87af0-ee53-485c-8ef9-616b51c6ae8c",
      "programName": "sample string 5",
      "memberId": "be5338ea-6914-4c19-bc0c-9dbc5ffc4444",
      "referralId": "84b15fbd-8c85-40b0-a404-4b4a1bc385ac",
      "type": "sample string 6",
      "recipientId": "3f36e319-262c-4340-b07c-f9accdfa3712",
      "recipientName": "sample string 7",
      "recipientEmailAddress": "sample string 8",
      "recipientExternalIdentifier": "sample string 9",
      "externalIdentifier": "sample string 10",
      "status": "sample string 11",
      "amount": 12.0,
      "createDate": "2024-03-29T12:53:13.2200049Z",
      "issueDate": "2024-03-29T12:53:13.2200049Z",
      "eligibilityDate": "2024-03-29T12:53:13.2200049Z",
      "description": "sample string 15",
      "transactionID": "f2ed70e2-f6e7-43e2-ba39-06a33050417f",
      "updateDate": "2024-03-29T12:53:13.2200049Z",
      "referralDisplayName": "sample string 17",
      "currencyCode": "sample string 18",
      "source": "sample string 19",
      "programRewardRuleId": "c33cb4dc-b18a-4c42-b2a6-56b1f8a4d9e9",
      "paymentType": "sample string 20",
      "paymentCode": "sample string 21",
      "completeNote": "sample string 22"
    },
    "resultInfo": {
      "Status": "sample string 1",
      "Message": "sample string 2"
    }
  },
  {
    "memberQuery": {
      "primaryInfo": {
        "memberId": "sample string 1",
        "referralCode": "sample string 2"
      },
      "secondaryInfo": {
        "externalIdentifier": "sample string 1",
        "email": "sample string 2"
      },
      "tertiaryInfo": {
        "programId": "sample string 1",
        "programName": "sample string 2",
        "programTitle": "sample string 3"
      }
    },
    "referralQuery": {
      "primaryInfo": {
        "referralId": "sample string 1"
      },
      "secondaryInfo": {
        "externalIdentifier": "sample string 1",
        "email": "sample string 2",
        "phoneNumber": "sample string 3"
      },
      "tertiaryInfo": {
        "ProgramId": "sample string 1",
        "ProgramName": "sample string 2",
        "ProgramTitle": "sample string 3"
      },
      "fuzzyInfo": {
        "Identifier": "sample string 1"
      }
    },
    "reward": {
      "id": "0217731e-7154-4c8c-a4cd-87aa35282e82",
      "payoutId": "05dde946-6b7b-448e-bf34-b657efd1b84e",
      "payoutDescription": "sample string 3",
      "programId": "c2c87af0-ee53-485c-8ef9-616b51c6ae8c",
      "programName": "sample string 5",
      "memberId": "be5338ea-6914-4c19-bc0c-9dbc5ffc4444",
      "referralId": "84b15fbd-8c85-40b0-a404-4b4a1bc385ac",
      "type": "sample string 6",
      "recipientId": "3f36e319-262c-4340-b07c-f9accdfa3712",
      "recipientName": "sample string 7",
      "recipientEmailAddress": "sample string 8",
      "recipientExternalIdentifier": "sample string 9",
      "externalIdentifier": "sample string 10",
      "status": "sample string 11",
      "amount": 12.0,
      "createDate": "2024-03-29T12:53:13.2200049Z",
      "issueDate": "2024-03-29T12:53:13.2200049Z",
      "eligibilityDate": "2024-03-29T12:53:13.2200049Z",
      "description": "sample string 15",
      "transactionID": "f2ed70e2-f6e7-43e2-ba39-06a33050417f",
      "updateDate": "2024-03-29T12:53:13.2200049Z",
      "referralDisplayName": "sample string 17",
      "currencyCode": "sample string 18",
      "source": "sample string 19",
      "programRewardRuleId": "c33cb4dc-b18a-4c42-b2a6-56b1f8a4d9e9",
      "paymentType": "sample string 20",
      "paymentCode": "sample string 21",
      "completeNote": "sample string 22"
    },
    "resultInfo": {
      "Status": "sample string 1",
      "Message": "sample string 2"
    }
  }
]

application/xml, text/xml

Sample:
<ArrayOfnewRewardResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <newRewardResult>
    <memberQuery>
      <primaryInfo>
        <memberId>sample string 1</memberId>
        <referralCode>sample string 2</referralCode>
      </primaryInfo>
      <secondaryInfo>
        <email>sample string 2</email>
        <externalIdentifier>sample string 1</externalIdentifier>
      </secondaryInfo>
      <tertiaryInfo>
        <programId>sample string 1</programId>
        <programName>sample string 2</programName>
        <programTitle>sample string 3</programTitle>
      </tertiaryInfo>
    </memberQuery>
    <referralQuery>
      <fuzzyInfo xmlns:d4p1="http://schemas.datacontract.org/2004/07/ReferralRock.Api.Models">
        <d4p1:Identifier>sample string 1</d4p1:Identifier>
      </fuzzyInfo>
      <primaryInfo>
        <referralId>sample string 1</referralId>
      </primaryInfo>
      <secondaryInfo>
        <email>sample string 2</email>
        <externalIdentifier>sample string 1</externalIdentifier>
        <phoneNumber>sample string 3</phoneNumber>
      </secondaryInfo>
      <tertiaryInfo xmlns:d4p1="http://schemas.datacontract.org/2004/07/ReferralRock.Api.Models">
        <d4p1:ProgramId>sample string 1</d4p1:ProgramId>
        <d4p1:ProgramName>sample string 2</d4p1:ProgramName>
        <d4p1:ProgramTitle>sample string 3</d4p1:ProgramTitle>
      </tertiaryInfo>
    </referralQuery>
    <resultInfo xmlns:d3p1="http://schemas.datacontract.org/2004/07/ReferralRock.Api.Models.Response">
      <d3p1:Message>sample string 2</d3p1:Message>
      <d3p1:Status>sample string 1</d3p1:Status>
    </resultInfo>
    <reward>
      <id>0217731e-7154-4c8c-a4cd-87aa35282e82</id>
      <payoutId>05dde946-6b7b-448e-bf34-b657efd1b84e</payoutId>
      <payoutDescription>sample string 3</payoutDescription>
      <programId>c2c87af0-ee53-485c-8ef9-616b51c6ae8c</programId>
      <programName>sample string 5</programName>
      <memberId>be5338ea-6914-4c19-bc0c-9dbc5ffc4444</memberId>
      <referralId>84b15fbd-8c85-40b0-a404-4b4a1bc385ac</referralId>
      <type>sample string 6</type>
      <recipientId>3f36e319-262c-4340-b07c-f9accdfa3712</recipientId>
      <recipientName>sample string 7</recipientName>
      <recipientEmailAddress>sample string 8</recipientEmailAddress>
      <recipientExternalIdentifier>sample string 9</recipientExternalIdentifier>
      <externalIdentifier>sample string 10</externalIdentifier>
      <status>sample string 11</status>
      <amount>12</amount>
      <createDate>2024-03-29T12:53:13.2200049+00:00</createDate>
      <issueDate>2024-03-29T12:53:13.2200049+00:00</issueDate>
      <eligibilityDate>2024-03-29T12:53:13.2200049+00:00</eligibilityDate>
      <description>sample string 15</description>
      <transactionID>f2ed70e2-f6e7-43e2-ba39-06a33050417f</transactionID>
      <updateDate>2024-03-29T12:53:13.2200049+00:00</updateDate>
      <referralDisplayName>sample string 17</referralDisplayName>
      <currencyCode>sample string 18</currencyCode>
      <source>sample string 19</source>
      <programRewardRuleId>c33cb4dc-b18a-4c42-b2a6-56b1f8a4d9e9</programRewardRuleId>
      <paymentType>sample string 20</paymentType>
      <paymentCode>sample string 21</paymentCode>
      <completeNote>sample string 22</completeNote>
    </reward>
  </newRewardResult>
  <newRewardResult>
    <memberQuery>
      <primaryInfo>
        <memberId>sample string 1</memberId>
        <referralCode>sample string 2</referralCode>
      </primaryInfo>
      <secondaryInfo>
        <email>sample string 2</email>
        <externalIdentifier>sample string 1</externalIdentifier>
      </secondaryInfo>
      <tertiaryInfo>
        <programId>sample string 1</programId>
        <programName>sample string 2</programName>
        <programTitle>sample string 3</programTitle>
      </tertiaryInfo>
    </memberQuery>
    <referralQuery>
      <fuzzyInfo xmlns:d4p1="http://schemas.datacontract.org/2004/07/ReferralRock.Api.Models">
        <d4p1:Identifier>sample string 1</d4p1:Identifier>
      </fuzzyInfo>
      <primaryInfo>
        <referralId>sample string 1</referralId>
      </primaryInfo>
      <secondaryInfo>
        <email>sample string 2</email>
        <externalIdentifier>sample string 1</externalIdentifier>
        <phoneNumber>sample string 3</phoneNumber>
      </secondaryInfo>
      <tertiaryInfo xmlns:d4p1="http://schemas.datacontract.org/2004/07/ReferralRock.Api.Models">
        <d4p1:ProgramId>sample string 1</d4p1:ProgramId>
        <d4p1:ProgramName>sample string 2</d4p1:ProgramName>
        <d4p1:ProgramTitle>sample string 3</d4p1:ProgramTitle>
      </tertiaryInfo>
    </referralQuery>
    <resultInfo xmlns:d3p1="http://schemas.datacontract.org/2004/07/ReferralRock.Api.Models.Response">
      <d3p1:Message>sample string 2</d3p1:Message>
      <d3p1:Status>sample string 1</d3p1:Status>
    </resultInfo>
    <reward>
      <id>0217731e-7154-4c8c-a4cd-87aa35282e82</id>
      <payoutId>05dde946-6b7b-448e-bf34-b657efd1b84e</payoutId>
      <payoutDescription>sample string 3</payoutDescription>
      <programId>c2c87af0-ee53-485c-8ef9-616b51c6ae8c</programId>
      <programName>sample string 5</programName>
      <memberId>be5338ea-6914-4c19-bc0c-9dbc5ffc4444</memberId>
      <referralId>84b15fbd-8c85-40b0-a404-4b4a1bc385ac</referralId>
      <type>sample string 6</type>
      <recipientId>3f36e319-262c-4340-b07c-f9accdfa3712</recipientId>
      <recipientName>sample string 7</recipientName>
      <recipientEmailAddress>sample string 8</recipientEmailAddress>
      <recipientExternalIdentifier>sample string 9</recipientExternalIdentifier>
      <externalIdentifier>sample string 10</externalIdentifier>
      <status>sample string 11</status>
      <amount>12</amount>
      <createDate>2024-03-29T12:53:13.2200049+00:00</createDate>
      <issueDate>2024-03-29T12:53:13.2200049+00:00</issueDate>
      <eligibilityDate>2024-03-29T12:53:13.2200049+00:00</eligibilityDate>
      <description>sample string 15</description>
      <transactionID>f2ed70e2-f6e7-43e2-ba39-06a33050417f</transactionID>
      <updateDate>2024-03-29T12:53:13.2200049+00:00</updateDate>
      <referralDisplayName>sample string 17</referralDisplayName>
      <currencyCode>sample string 18</currencyCode>
      <source>sample string 19</source>
      <programRewardRuleId>c33cb4dc-b18a-4c42-b2a6-56b1f8a4d9e9</programRewardRuleId>
      <paymentType>sample string 20</paymentType>
      <paymentCode>sample string 21</paymentCode>
      <completeNote>sample string 22</completeNote>
    </reward>
  </newRewardResult>
</ArrayOfnewRewardResult>