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
Name | Description | Type | Additional 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
[ { "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": "2025-10-13T08:16:30.7634141Z", "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": "2025-10-13T08:16:30.7634141Z", "description": "sample string 3" } } ]
application/xml, text/xml
<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>2025-10-13T08:16:30.7634141+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>2025-10-13T08:16:30.7634141+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
Name | Description | Type | Additional 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
[ { "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": "b251b38f-8f38-44d9-aa25-b323fb11be42", "payoutId": "4a7551ad-c235-4792-82d0-906e41a7b467", "payoutDescription": "sample string 3", "programId": "4129fed7-d909-445a-9c73-c4a772c885e7", "programName": "sample string 5", "memberId": "50fda726-b845-4057-bf1d-57699f77f51d", "referralId": "4ebed0ef-fe81-40c8-82c2-974f14ae174d", "type": "sample string 6", "recipientId": "9fe4f0c3-7a77-4411-9217-a683ab4abe0c", "recipientName": "sample string 7", "recipientEmailAddress": "sample string 8", "recipientExternalIdentifier": "sample string 9", "externalIdentifier": "sample string 10", "status": "sample string 11", "amount": 12.0, "createDate": "2025-10-13T08:16:30.779033Z", "issueDate": "2025-10-13T08:16:30.779033Z", "eligibilityDate": "2025-10-13T08:16:30.779033Z", "description": "sample string 15", "transactionID": "3b08e9a8-9e4d-479a-94b0-ef475b0fd4b1", "updateDate": "2025-10-13T08:16:30.779033Z", "referralDisplayName": "sample string 17", "currencyCode": "sample string 18", "source": "sample string 19", "programRewardRuleId": "92301067-50a0-4cd6-82ec-e8e0d2a0815b", "paymentType": "sample string 20", "paymentCode": "sample string 21", "completeNote": "sample string 22", "reason": "sample string 23", "reasonOther": "sample string 24" }, "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": "b251b38f-8f38-44d9-aa25-b323fb11be42", "payoutId": "4a7551ad-c235-4792-82d0-906e41a7b467", "payoutDescription": "sample string 3", "programId": "4129fed7-d909-445a-9c73-c4a772c885e7", "programName": "sample string 5", "memberId": "50fda726-b845-4057-bf1d-57699f77f51d", "referralId": "4ebed0ef-fe81-40c8-82c2-974f14ae174d", "type": "sample string 6", "recipientId": "9fe4f0c3-7a77-4411-9217-a683ab4abe0c", "recipientName": "sample string 7", "recipientEmailAddress": "sample string 8", "recipientExternalIdentifier": "sample string 9", "externalIdentifier": "sample string 10", "status": "sample string 11", "amount": 12.0, "createDate": "2025-10-13T08:16:30.779033Z", "issueDate": "2025-10-13T08:16:30.779033Z", "eligibilityDate": "2025-10-13T08:16:30.779033Z", "description": "sample string 15", "transactionID": "3b08e9a8-9e4d-479a-94b0-ef475b0fd4b1", "updateDate": "2025-10-13T08:16:30.779033Z", "referralDisplayName": "sample string 17", "currencyCode": "sample string 18", "source": "sample string 19", "programRewardRuleId": "92301067-50a0-4cd6-82ec-e8e0d2a0815b", "paymentType": "sample string 20", "paymentCode": "sample string 21", "completeNote": "sample string 22", "reason": "sample string 23", "reasonOther": "sample string 24" }, "resultInfo": { "Status": "sample string 1", "Message": "sample string 2" } } ]
application/xml, text/xml
<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>b251b38f-8f38-44d9-aa25-b323fb11be42</id> <payoutId>4a7551ad-c235-4792-82d0-906e41a7b467</payoutId> <payoutDescription>sample string 3</payoutDescription> <programId>4129fed7-d909-445a-9c73-c4a772c885e7</programId> <programName>sample string 5</programName> <memberId>50fda726-b845-4057-bf1d-57699f77f51d</memberId> <referralId>4ebed0ef-fe81-40c8-82c2-974f14ae174d</referralId> <type>sample string 6</type> <recipientId>9fe4f0c3-7a77-4411-9217-a683ab4abe0c</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>2025-10-13T08:16:30.779033+00:00</createDate> <issueDate>2025-10-13T08:16:30.779033+00:00</issueDate> <eligibilityDate>2025-10-13T08:16:30.779033+00:00</eligibilityDate> <description>sample string 15</description> <transactionID>3b08e9a8-9e4d-479a-94b0-ef475b0fd4b1</transactionID> <updateDate>2025-10-13T08:16:30.779033+00:00</updateDate> <referralDisplayName>sample string 17</referralDisplayName> <currencyCode>sample string 18</currencyCode> <source>sample string 19</source> <programRewardRuleId>92301067-50a0-4cd6-82ec-e8e0d2a0815b</programRewardRuleId> <paymentType>sample string 20</paymentType> <paymentCode>sample string 21</paymentCode> <completeNote>sample string 22</completeNote> <reason>sample string 23</reason> <reasonOther>sample string 24</reasonOther> </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>b251b38f-8f38-44d9-aa25-b323fb11be42</id> <payoutId>4a7551ad-c235-4792-82d0-906e41a7b467</payoutId> <payoutDescription>sample string 3</payoutDescription> <programId>4129fed7-d909-445a-9c73-c4a772c885e7</programId> <programName>sample string 5</programName> <memberId>50fda726-b845-4057-bf1d-57699f77f51d</memberId> <referralId>4ebed0ef-fe81-40c8-82c2-974f14ae174d</referralId> <type>sample string 6</type> <recipientId>9fe4f0c3-7a77-4411-9217-a683ab4abe0c</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>2025-10-13T08:16:30.779033+00:00</createDate> <issueDate>2025-10-13T08:16:30.779033+00:00</issueDate> <eligibilityDate>2025-10-13T08:16:30.779033+00:00</eligibilityDate> <description>sample string 15</description> <transactionID>3b08e9a8-9e4d-479a-94b0-ef475b0fd4b1</transactionID> <updateDate>2025-10-13T08:16:30.779033+00:00</updateDate> <referralDisplayName>sample string 17</referralDisplayName> <currencyCode>sample string 18</currencyCode> <source>sample string 19</source> <programRewardRuleId>92301067-50a0-4cd6-82ec-e8e0d2a0815b</programRewardRuleId> <paymentType>sample string 20</paymentType> <paymentCode>sample string 21</paymentCode> <completeNote>sample string 22</completeNote> <reason>sample string 23</reason> <reasonOther>sample string 24</reasonOther> </reward> </newRewardResult> </ArrayOfnewRewardResult>