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

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": "2025-10-05T14:23:45.9799063Z",
      "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-05T14:23:45.9799063Z",
      "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>2025-10-05T14:23:45.9799063+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-05T14:23:45.9799063+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

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": "f2489546-a2c6-4be2-aa52-96cd2e9aa513",
      "payoutId": "c7286e59-f799-4ab9-a268-3202b9677517",
      "payoutDescription": "sample string 3",
      "programId": "f42286f7-02f7-43a1-9f18-2d4cbc1c3c13",
      "programName": "sample string 5",
      "memberId": "e10b0ec0-d28c-4308-9b62-94ce16717d10",
      "referralId": "4d405646-447f-4ec1-895b-8b45b61f92f7",
      "type": "sample string 6",
      "recipientId": "719f6240-cecb-452b-9795-72803508edf0",
      "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-05T14:23:45.9799063Z",
      "issueDate": "2025-10-05T14:23:45.9799063Z",
      "eligibilityDate": "2025-10-05T14:23:45.9799063Z",
      "description": "sample string 15",
      "transactionID": "0b41202d-1ea9-4a93-8bbd-c4c3875314d5",
      "updateDate": "2025-10-05T14:23:45.9799063Z",
      "referralDisplayName": "sample string 17",
      "currencyCode": "sample string 18",
      "source": "sample string 19",
      "programRewardRuleId": "d0f26d6d-322d-4823-9bd2-48da363fd142",
      "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": "f2489546-a2c6-4be2-aa52-96cd2e9aa513",
      "payoutId": "c7286e59-f799-4ab9-a268-3202b9677517",
      "payoutDescription": "sample string 3",
      "programId": "f42286f7-02f7-43a1-9f18-2d4cbc1c3c13",
      "programName": "sample string 5",
      "memberId": "e10b0ec0-d28c-4308-9b62-94ce16717d10",
      "referralId": "4d405646-447f-4ec1-895b-8b45b61f92f7",
      "type": "sample string 6",
      "recipientId": "719f6240-cecb-452b-9795-72803508edf0",
      "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-05T14:23:45.9799063Z",
      "issueDate": "2025-10-05T14:23:45.9799063Z",
      "eligibilityDate": "2025-10-05T14:23:45.9799063Z",
      "description": "sample string 15",
      "transactionID": "0b41202d-1ea9-4a93-8bbd-c4c3875314d5",
      "updateDate": "2025-10-05T14:23:45.9799063Z",
      "referralDisplayName": "sample string 17",
      "currencyCode": "sample string 18",
      "source": "sample string 19",
      "programRewardRuleId": "d0f26d6d-322d-4823-9bd2-48da363fd142",
      "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

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>f2489546-a2c6-4be2-aa52-96cd2e9aa513</id>
      <payoutId>c7286e59-f799-4ab9-a268-3202b9677517</payoutId>
      <payoutDescription>sample string 3</payoutDescription>
      <programId>f42286f7-02f7-43a1-9f18-2d4cbc1c3c13</programId>
      <programName>sample string 5</programName>
      <memberId>e10b0ec0-d28c-4308-9b62-94ce16717d10</memberId>
      <referralId>4d405646-447f-4ec1-895b-8b45b61f92f7</referralId>
      <type>sample string 6</type>
      <recipientId>719f6240-cecb-452b-9795-72803508edf0</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-05T14:23:45.9799063+00:00</createDate>
      <issueDate>2025-10-05T14:23:45.9799063+00:00</issueDate>
      <eligibilityDate>2025-10-05T14:23:45.9799063+00:00</eligibilityDate>
      <description>sample string 15</description>
      <transactionID>0b41202d-1ea9-4a93-8bbd-c4c3875314d5</transactionID>
      <updateDate>2025-10-05T14:23:45.9799063+00:00</updateDate>
      <referralDisplayName>sample string 17</referralDisplayName>
      <currencyCode>sample string 18</currencyCode>
      <source>sample string 19</source>
      <programRewardRuleId>d0f26d6d-322d-4823-9bd2-48da363fd142</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>f2489546-a2c6-4be2-aa52-96cd2e9aa513</id>
      <payoutId>c7286e59-f799-4ab9-a268-3202b9677517</payoutId>
      <payoutDescription>sample string 3</payoutDescription>
      <programId>f42286f7-02f7-43a1-9f18-2d4cbc1c3c13</programId>
      <programName>sample string 5</programName>
      <memberId>e10b0ec0-d28c-4308-9b62-94ce16717d10</memberId>
      <referralId>4d405646-447f-4ec1-895b-8b45b61f92f7</referralId>
      <type>sample string 6</type>
      <recipientId>719f6240-cecb-452b-9795-72803508edf0</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-05T14:23:45.9799063+00:00</createDate>
      <issueDate>2025-10-05T14:23:45.9799063+00:00</issueDate>
      <eligibilityDate>2025-10-05T14:23:45.9799063+00:00</eligibilityDate>
      <description>sample string 15</description>
      <transactionID>0b41202d-1ea9-4a93-8bbd-c4c3875314d5</transactionID>
      <updateDate>2025-10-05T14:23:45.9799063+00:00</updateDate>
      <referralDisplayName>sample string 17</referralDisplayName>
      <currencyCode>sample string 18</currencyCode>
      <source>sample string 19</source>
      <programRewardRuleId>d0f26d6d-322d-4823-9bd2-48da363fd142</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>