POST api/rewards/issue

Issue a specific reward.

Request Information

URI Parameters

Query String: overrideIneligible={overrideIneligible}

Name	Description	Type	Additional information
overrideIneligible	Allows you to override eligiblity date rules. Issue rewards with eligibility dates in the future. Optional.	boolean	Default value is False

Body Parameters

Data needed for issuing a reward. Required.

Type: IssueRewardInfo

Name	Description	Type	Additional information
rewardId	The unique ID of the reward to issue.	string	Required
recipientInfo	(deprecated) Additional info about the reward to issue. In most cases, this can be left blank. For PayPal, include the email address of the recipient. Optional.	string	None.
note	A message to be sent to the recipient of the reward. Optional.	string	None.

Request Formats

application/json, text/json

Sample:

{
  "rewardId": "sample string 1",
  "recipientInfo": "sample string 2",
  "note": "sample string 3"
}

application/xml, text/xml

Sample:

<issueReward xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <note>sample string 3</note>
  <recipientInfo>sample string 2</recipientInfo>
  <rewardId>sample string 1</rewardId>
</issueReward>

Response Information

Resource Description

[HTTP Status 200 - OK]

Type: IssueRewardResult

Name	Description	Type	Additional information
reward	The reward, after the attempt to issue it has been received.	Reward	None.
resultInfo	Details about the results of the request.	ResultInfo	None.

Response Formats

application/json, text/json

Sample:

{
  "reward": {
    "id": "87e6220e-7e9b-4869-9d38-c8ac3d2490dd",
    "payoutId": "62749021-4578-4405-9234-e35b42d21707",
    "payoutDescription": "sample string 3",
    "programId": "404d01bc-d67c-4d33-9d1e-ce219a9c4865",
    "programName": "sample string 5",
    "memberId": "f816e9ff-4631-4b89-96dc-1cda1276151c",
    "referralId": "40f8f90d-f060-4050-93f1-9ce97469e59e",
    "type": "sample string 6",
    "recipientId": "d28917a7-11a2-4603-b77a-ed12ef4a0d2f",
    "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-06-06T23:59:09.9773731Z",
    "issueDate": "2025-06-06T23:59:09.9773731Z",
    "eligibilityDate": "2025-06-06T23:59:09.9773731Z",
    "description": "sample string 15",
    "transactionID": "87b58779-f4f3-41fa-b80f-4cb449940b8f",
    "updateDate": "2025-06-06T23:59:09.9773731Z",
    "referralDisplayName": "sample string 17",
    "currencyCode": "sample string 18",
    "source": "sample string 19",
    "programRewardRuleId": "aab77fb5-75d6-4f20-bc6d-0f96041a09f0",
    "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:

<issueRewardResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <resultInfo xmlns:d2p1="http://schemas.datacontract.org/2004/07/ReferralRock.Api.Models.Response">
    <d2p1:Message>sample string 2</d2p1:Message>
    <d2p1:Status>sample string 1</d2p1:Status>
  </resultInfo>
  <reward>
    <id>87e6220e-7e9b-4869-9d38-c8ac3d2490dd</id>
    <payoutId>62749021-4578-4405-9234-e35b42d21707</payoutId>
    <payoutDescription>sample string 3</payoutDescription>
    <programId>404d01bc-d67c-4d33-9d1e-ce219a9c4865</programId>
    <programName>sample string 5</programName>
    <memberId>f816e9ff-4631-4b89-96dc-1cda1276151c</memberId>
    <referralId>40f8f90d-f060-4050-93f1-9ce97469e59e</referralId>
    <type>sample string 6</type>
    <recipientId>d28917a7-11a2-4603-b77a-ed12ef4a0d2f</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-06-06T23:59:09.9773731+00:00</createDate>
    <issueDate>2025-06-06T23:59:09.9773731+00:00</issueDate>
    <eligibilityDate>2025-06-06T23:59:09.9773731+00:00</eligibilityDate>
    <description>sample string 15</description>
    <transactionID>87b58779-f4f3-41fa-b80f-4cb449940b8f</transactionID>
    <updateDate>2025-06-06T23:59:09.9773731+00:00</updateDate>
    <referralDisplayName>sample string 17</referralDisplayName>
    <currencyCode>sample string 18</currencyCode>
    <source>sample string 19</source>
    <programRewardRuleId>aab77fb5-75d6-4f20-bc6d-0f96041a09f0</programRewardRuleId>
    <paymentType>sample string 20</paymentType>
    <paymentCode>sample string 21</paymentCode>
    <completeNote>sample string 22</completeNote>
  </reward>
</issueRewardResult>