Create a Premium

curl --request POST \
  --url https://prod-api.raisedonors.com/api/Premium \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "code": "<string>",
  "nameShort": "<string>",
  "description": "<string>",
  "price": 500000000000,
  "fairMarketValue": 500000000000,
  "digitalUrl": "<string>",
  "isActive": true,
  "isFree": true,
  "inventory": 123,
  "keepActiveWhenHasNoInventory": true,
  "recurringPremiumId": 123,
  "projectId": 123,
  "image": "<string>",
  "externalIdentifier": "<string>",
  "otherMinimumAmounts": [
    {
      "currency": "<string>",
      "value": 123
    }
  ]
}
'

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    code: '<string>',
    nameShort: '<string>',
    description: '<string>',
    price: 500000000000,
    fairMarketValue: 500000000000,
    digitalUrl: '<string>',
    isActive: true,
    isFree: true,
    inventory: 123,
    keepActiveWhenHasNoInventory: true,
    recurringPremiumId: 123,
    projectId: 123,
    image: '<string>',
    externalIdentifier: '<string>',
    otherMinimumAmounts: [{currency: '<string>', value: 123}]
  })
};

fetch('https://prod-api.raisedonors.com/api/Premium', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://prod-api.raisedonors.com/api/Premium"

payload = {
    "name": "<string>",
    "code": "<string>",
    "nameShort": "<string>",
    "description": "<string>",
    "price": 500000000000,
    "fairMarketValue": 500000000000,
    "digitalUrl": "<string>",
    "isActive": True,
    "isFree": True,
    "inventory": 123,
    "keepActiveWhenHasNoInventory": True,
    "recurringPremiumId": 123,
    "projectId": 123,
    "image": "<string>",
    "externalIdentifier": "<string>",
    "otherMinimumAmounts": [
        {
            "currency": "<string>",
            "value": 123
        }
    ]
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

using RestSharp;


var options = new RestClientOptions("https://prod-api.raisedonors.com/api/Premium");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "<api-key>");
request.AddJsonBody("{\n  \"name\": \"<string>\",\n  \"code\": \"<string>\",\n  \"nameShort\": \"<string>\",\n  \"description\": \"<string>\",\n  \"price\": 500000000000,\n  \"fairMarketValue\": 500000000000,\n  \"digitalUrl\": \"<string>\",\n  \"isActive\": true,\n  \"isFree\": true,\n  \"inventory\": 123,\n  \"keepActiveWhenHasNoInventory\": true,\n  \"recurringPremiumId\": 123,\n  \"projectId\": 123,\n  \"image\": \"<string>\",\n  \"externalIdentifier\": \"<string>\",\n  \"otherMinimumAmounts\": [\n    {\n      \"currency\": \"<string>\",\n      \"value\": 123\n    }\n  ]\n}", false);
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://prod-api.raisedonors.com/api/Premium",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'code' => '<string>',
    'nameShort' => '<string>',
    'description' => '<string>',
    'price' => 500000000000,
    'fairMarketValue' => 500000000000,
    'digitalUrl' => '<string>',
    'isActive' => true,
    'isFree' => true,
    'inventory' => 123,
    'keepActiveWhenHasNoInventory' => true,
    'recurringPremiumId' => 123,
    'projectId' => 123,
    'image' => '<string>',
    'externalIdentifier' => '<string>',
    'otherMinimumAmounts' => [
        [
                'currency' => '<string>',
                'value' => 123
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

HttpResponse<String> response = Unirest.post("https://prod-api.raisedonors.com/api/Premium")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"code\": \"<string>\",\n  \"nameShort\": \"<string>\",\n  \"description\": \"<string>\",\n  \"price\": 500000000000,\n  \"fairMarketValue\": 500000000000,\n  \"digitalUrl\": \"<string>\",\n  \"isActive\": true,\n  \"isFree\": true,\n  \"inventory\": 123,\n  \"keepActiveWhenHasNoInventory\": true,\n  \"recurringPremiumId\": 123,\n  \"projectId\": 123,\n  \"image\": \"<string>\",\n  \"externalIdentifier\": \"<string>\",\n  \"otherMinimumAmounts\": [\n    {\n      \"currency\": \"<string>\",\n      \"value\": 123\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://prod-api.raisedonors.com/api/Premium")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"code\": \"<string>\",\n  \"nameShort\": \"<string>\",\n  \"description\": \"<string>\",\n  \"price\": 500000000000,\n  \"fairMarketValue\": 500000000000,\n  \"digitalUrl\": \"<string>\",\n  \"isActive\": true,\n  \"isFree\": true,\n  \"inventory\": 123,\n  \"keepActiveWhenHasNoInventory\": true,\n  \"recurringPremiumId\": 123,\n  \"projectId\": 123,\n  \"image\": \"<string>\",\n  \"externalIdentifier\": \"<string>\",\n  \"otherMinimumAmounts\": [\n    {\n      \"currency\": \"<string>\",\n      \"value\": 123\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

const url = 'https://prod-api.raisedonors.com/api/Premium';
const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    code: '<string>',
    nameShort: '<string>',
    description: '<string>',
    price: 500000000000,
    fairMarketValue: 500000000000,
    digitalUrl: '<string>',
    isActive: true,
    isFree: true,
    inventory: 123,
    keepActiveWhenHasNoInventory: true,
    recurringPremiumId: 123,
    projectId: 123,
    image: '<string>',
    externalIdentifier: '<string>',
    otherMinimumAmounts: [{currency: '<string>', value: 123}]
  })
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

{
  "id": 8210,
  "currency": "USD",
  "name": "Riverside Hope Canvas Tote Bag",
  "nameShort": "Tote Bag",
  "code": "TOTE-2025",
  "description": "Canvas tote bag sent to donors giving $35 or more.",
  "isActive": true,
  "price": 35,
  "formattedPrice": "$35.00",
  "fairMarketValue": 12,
  "formattedFairMarketValue": "$12.00",
  "inventory": 240,
  "keepActiveWhenHasNoInventory": false,
  "recurringPremiumId": null,
  "recurringPremiumName": null,
  "image": "https://cdn.riversidehope.example.org/premiums/tote-2025.jpg",
  "externalIdentifier": "TOTE-2025",
  "otherMinimumAmounts": [
    {
      "currency": "CAD",
      "value": 48
    }
  ]
}

{
  "type": "https://tools.ietf.org/html/rfc7231#section-6.5.1",
  "title": "One or more validation errors occurred.",
  "status": 400,
  "errors": {
    "price": [
      "Price must be greater than zero."
    ]
  },
  "instance": "/api/Premium"
}

{
  "type": "https://tools.ietf.org/html/rfc7235#section-3.1",
  "title": "Unauthorized",
  "status": 401,
  "detail": "The Authorization header is missing, malformed, or carries a token that is expired or revoked.",
  "instance": "/api/Premium"
}

POST

https://prod-api.raisedonors.com

api

Premium

Create a Premium

curl --request POST \
  --url https://prod-api.raisedonors.com/api/Premium \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "code": "<string>",
  "nameShort": "<string>",
  "description": "<string>",
  "price": 500000000000,
  "fairMarketValue": 500000000000,
  "digitalUrl": "<string>",
  "isActive": true,
  "isFree": true,
  "inventory": 123,
  "keepActiveWhenHasNoInventory": true,
  "recurringPremiumId": 123,
  "projectId": 123,
  "image": "<string>",
  "externalIdentifier": "<string>",
  "otherMinimumAmounts": [
    {
      "currency": "<string>",
      "value": 123
    }
  ]
}
'

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    code: '<string>',
    nameShort: '<string>',
    description: '<string>',
    price: 500000000000,
    fairMarketValue: 500000000000,
    digitalUrl: '<string>',
    isActive: true,
    isFree: true,
    inventory: 123,
    keepActiveWhenHasNoInventory: true,
    recurringPremiumId: 123,
    projectId: 123,
    image: '<string>',
    externalIdentifier: '<string>',
    otherMinimumAmounts: [{currency: '<string>', value: 123}]
  })
};

fetch('https://prod-api.raisedonors.com/api/Premium', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://prod-api.raisedonors.com/api/Premium"

payload = {
    "name": "<string>",
    "code": "<string>",
    "nameShort": "<string>",
    "description": "<string>",
    "price": 500000000000,
    "fairMarketValue": 500000000000,
    "digitalUrl": "<string>",
    "isActive": True,
    "isFree": True,
    "inventory": 123,
    "keepActiveWhenHasNoInventory": True,
    "recurringPremiumId": 123,
    "projectId": 123,
    "image": "<string>",
    "externalIdentifier": "<string>",
    "otherMinimumAmounts": [
        {
            "currency": "<string>",
            "value": 123
        }
    ]
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

using RestSharp;


var options = new RestClientOptions("https://prod-api.raisedonors.com/api/Premium");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "<api-key>");
request.AddJsonBody("{\n  \"name\": \"<string>\",\n  \"code\": \"<string>\",\n  \"nameShort\": \"<string>\",\n  \"description\": \"<string>\",\n  \"price\": 500000000000,\n  \"fairMarketValue\": 500000000000,\n  \"digitalUrl\": \"<string>\",\n  \"isActive\": true,\n  \"isFree\": true,\n  \"inventory\": 123,\n  \"keepActiveWhenHasNoInventory\": true,\n  \"recurringPremiumId\": 123,\n  \"projectId\": 123,\n  \"image\": \"<string>\",\n  \"externalIdentifier\": \"<string>\",\n  \"otherMinimumAmounts\": [\n    {\n      \"currency\": \"<string>\",\n      \"value\": 123\n    }\n  ]\n}", false);
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://prod-api.raisedonors.com/api/Premium",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'code' => '<string>',
    'nameShort' => '<string>',
    'description' => '<string>',
    'price' => 500000000000,
    'fairMarketValue' => 500000000000,
    'digitalUrl' => '<string>',
    'isActive' => true,
    'isFree' => true,
    'inventory' => 123,
    'keepActiveWhenHasNoInventory' => true,
    'recurringPremiumId' => 123,
    'projectId' => 123,
    'image' => '<string>',
    'externalIdentifier' => '<string>',
    'otherMinimumAmounts' => [
        [
                'currency' => '<string>',
                'value' => 123
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

HttpResponse<String> response = Unirest.post("https://prod-api.raisedonors.com/api/Premium")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"code\": \"<string>\",\n  \"nameShort\": \"<string>\",\n  \"description\": \"<string>\",\n  \"price\": 500000000000,\n  \"fairMarketValue\": 500000000000,\n  \"digitalUrl\": \"<string>\",\n  \"isActive\": true,\n  \"isFree\": true,\n  \"inventory\": 123,\n  \"keepActiveWhenHasNoInventory\": true,\n  \"recurringPremiumId\": 123,\n  \"projectId\": 123,\n  \"image\": \"<string>\",\n  \"externalIdentifier\": \"<string>\",\n  \"otherMinimumAmounts\": [\n    {\n      \"currency\": \"<string>\",\n      \"value\": 123\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://prod-api.raisedonors.com/api/Premium")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"code\": \"<string>\",\n  \"nameShort\": \"<string>\",\n  \"description\": \"<string>\",\n  \"price\": 500000000000,\n  \"fairMarketValue\": 500000000000,\n  \"digitalUrl\": \"<string>\",\n  \"isActive\": true,\n  \"isFree\": true,\n  \"inventory\": 123,\n  \"keepActiveWhenHasNoInventory\": true,\n  \"recurringPremiumId\": 123,\n  \"projectId\": 123,\n  \"image\": \"<string>\",\n  \"externalIdentifier\": \"<string>\",\n  \"otherMinimumAmounts\": [\n    {\n      \"currency\": \"<string>\",\n      \"value\": 123\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

const url = 'https://prod-api.raisedonors.com/api/Premium';
const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    code: '<string>',
    nameShort: '<string>',
    description: '<string>',
    price: 500000000000,
    fairMarketValue: 500000000000,
    digitalUrl: '<string>',
    isActive: true,
    isFree: true,
    inventory: 123,
    keepActiveWhenHasNoInventory: true,
    recurringPremiumId: 123,
    projectId: 123,
    image: '<string>',
    externalIdentifier: '<string>',
    otherMinimumAmounts: [{currency: '<string>', value: 123}]
  })
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

{
  "id": 8210,
  "currency": "USD",
  "name": "Riverside Hope Canvas Tote Bag",
  "nameShort": "Tote Bag",
  "code": "TOTE-2025",
  "description": "Canvas tote bag sent to donors giving $35 or more.",
  "isActive": true,
  "price": 35,
  "formattedPrice": "$35.00",
  "fairMarketValue": 12,
  "formattedFairMarketValue": "$12.00",
  "inventory": 240,
  "keepActiveWhenHasNoInventory": false,
  "recurringPremiumId": null,
  "recurringPremiumName": null,
  "image": "https://cdn.riversidehope.example.org/premiums/tote-2025.jpg",
  "externalIdentifier": "TOTE-2025",
  "otherMinimumAmounts": [
    {
      "currency": "CAD",
      "value": 48
    }
  ]
}

{
  "type": "https://tools.ietf.org/html/rfc7231#section-6.5.1",
  "title": "One or more validation errors occurred.",
  "status": 400,
  "errors": {
    "price": [
      "Price must be greater than zero."
    ]
  },
  "instance": "/api/Premium"
}

{
  "type": "https://tools.ietf.org/html/rfc7235#section-3.1",
  "title": "Unauthorized",
  "status": 401,
  "detail": "The Authorization header is missing, malformed, or carries a token that is expired or revoked.",
  "instance": "/api/Premium"
}

Send its name, code, price, and fairMarketValue, set inventory and keepActiveWhenHasNoInventory to control availability, and use otherMinimumAmounts to set the gift amounts that qualify. Returns the created premium with its new id, which you can pass as premiumId when processing a donation.

Authorizations

Authorization

string

header

required

JWT Authorization header using the Bearer scheme. Example: "Authorization: Bearer {token}"

Body

The premium request model.

Represents a premium request.

name

string

required

The name of the premium.

Required string length: 1 - 255

code

string

required

The code that identifies the premium.

Required string length: 1 - 100

nameShort

string | null

The short name of the premium, used where space is limited.

Maximum string length: 150

description

string | null

The description of the premium.

price

number<double>

The amount a donor must give to receive the premium.

Required range: 0 <= x <= 1000000000000

fairMarketValue

number<double>

The fair market value of the premium, used for tax receipting.

Required range: 0 <= x <= 1000000000000

digitalUrl

string | null

The URL a digital premium is delivered from.

isActive

boolean

Whether the premium is active.

isFree

boolean

Whether the premium is offered at no minimum gift amount.

inventory

integer<int32> | null

The number of units of the premium left in stock.

keepActiveWhenHasNoInventory

boolean

Whether the premium stays active when it has no inventory.

recurringPremiumId

integer<int64> | null

The unique identifier of the premium to send for recurring gifts instead.

projectId

integer<int64> | null

The unique identifier of the project the cost of the premium is charged to.

image

string | null

The URL of the image shown for the premium.

externalIdentifier

string | null

An identifier of your own to store on the premium, for reconciling it with an external system.

otherMinimumAmounts

object[] | null

The minimum gift amounts that qualify for the premium in other currencies.

Show child attributes

Response

Represents a premium model.

integer<int64>

The unique identifier of the premium.

currency

string | null

The three-letter ISO currency code of the price and fair market value.

name

string | null

The name of the premium.

nameShort

string | null

The short name of the premium, used where space is limited.

code

string | null

The code of the premium.

description

string | null

The description of the premium.

isActive

boolean

Whether the premium is active.

price

number<double>

The amount a donor must give to receive the premium.

formattedPrice

string | null

read-only

The price, formatted for display in its currency.

fairMarketValue

number<double> | null

The fair market value of the premium, used for tax receipting.

formattedFairMarketValue

string | null

read-only

The fair market value, formatted for display in its currency.

inventory

integer<int32> | null

The number of units of the premium left in stock.

keepActiveWhenHasNoInventory

boolean

Whether the premium stays active when it has no inventory.

recurringPremiumId

integer<int64> | null

The unique identifier of the premium sent for recurring gifts instead.

recurringPremiumName

string | null

The name of the premium sent for recurring gifts instead.

image

string | null

The URL of the image shown for the premium.

externalIdentifier

string | null

An identifier of your own to store on the premium, for reconciling it with an external system.

otherMinimumAmounts

object[] | null

The minimum gift amounts that qualify for the premium in other currencies.

Show child attributes

Last modified on July 28, 2026

⌘I

Activity

Campaign

CustomField

Donor

EmailList

Gift

MotivationCode

OrgKnowledge

Premium

Project

Query

Raise

RecurringGift

Segment

Webhook

Zapier

Create a Premium

Authorizations

Body

Response