Skip to main content
POST
/
api
/
Gift
Create a Gift *not recommended*
curl --request POST \
  --url https://api.virtuoussoftware.com/api/Gift \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contactId": "<integer>",
  "giftType": "Cash",
  "giftDate": "<dateTime>",
  "amount": "<double>",
  "transactionSource": "<string>",
  "transactionId": "<string>",
  "batch": "<string>",
  "segmentId": "<integer>",
  "receiptSegmentId": "<integer>",
  "mediaOutletId": "<integer>",
  "notes": "<string>",
  "isPrivate": "<boolean>",
  "receiptDate": "<dateTime>",
  "contactIndividualId": "<integer>",
  "contactPassthroughId": "<integer>",
  "cashAccountingCode": "<string>",
  "state": "<string>",
  "isTaxDeductible": "<boolean>",
  "giftAskId": "<integer>",
  "passthroughGiftAskId": "<integer>",
  "grantId": "<integer>",
  "contactMembershipId": "<integer>",
  "currencyCode": "<string>",
  "exchangeRate": "<decimal>",
  "checkNumber": "<string>",
  "creditCardType": "<string>",
  "cryptocoinType": "<string>",
  "transactionHash": "<string>",
  "coinSoldForCash": "<boolean>",
  "coinAmount": "<double>",
  "dateCoinWasSold": "<dateTime>",
  "coinSaleAmount": "<double>",
  "tickerSymbol": "<string>",
  "numberOfShares": "<double>",
  "iraCustodian": "<string>",
  "stockSoldForCash": "<boolean>",
  "dateStockWasSold": "<dateTime>",
  "stockSaleAmount": "<double>",
  "nonCashGiftTypeId": "<integer>",
  "nonCashGiftType": "<string>",
  "description": "<string>",
  "nonCashSoldForCash": "<boolean>",
  "dateNonCashWasSold": "<dateTime>",
  "nonCashOriginalAmount": "<double>",
  "nonCashSaleAmount": "<double>",
  "giftDesignations": [
    {
      "projectId": "<integer>",
      "amount": "<double>",
      "state": "<string>"
    },
    {
      "projectId": "<integer>",
      "amount": "<double>",
      "state": "<string>"
    }
  ],
  "giftPremiums": [
    {
      "premiumId": "<integer>",
      "quantity": "<integer>",
      "state": "<string>"
    },
    {
      "premiumId": "<integer>",
      "quantity": "<integer>",
      "state": "<string>"
    }
  ],
  "pledgePayments": [
    {
      "id": "<integer>",
      "amount": "<double>",
      "state": "<string>"
    },
    {
      "id": "<integer>",
      "amount": "<double>",
      "state": "<string>"
    }
  ],
  "recurringGiftPayments": [
    {
      "id": "<integer>",
      "paymentId": "RecurringGiftPayment-<integer>",
      "amount": "<double>",
      "state": "<string>"
    },
    {
      "id": "<integer>",
      "paymentId": "RecurringGiftPayment-<integer>",
      "amount": "<double>",
      "state": "<string>"
    }
  ],
  "tributeType": "<string>",
  "tributeId": "<integer>",
  "tributeDescription": "<string>",
  "acknowledgeeId": "<integer>",
  "reversedGiftId": "<integer>",
  "customFields": [
    {
      "name": "<string>",
      "value": "<string>",
      "displayName": "<string>"
    },
    {
      "name": "<string>",
      "value": "<string>",
      "displayName": "<string>"
    }
  ]
}
'
{
  "id": "<integer>",
  "transactionSource": "<string>",
  "transactionId": "<string>",
  "contactId": "<integer>",
  "contactName": "<string>",
  "contactUrl": "<string>",
  "giftType": "<string>",
  "giftTypeFormatted": "<string>",
  "giftDate": "<dateTime>",
  "giftDateFormatted": "<string>",
  "amount": "<double>",
  "amountFormatted": "<string>",
  "currencyCode": "<string>",
  "exchangeRate": "<decimal>",
  "baseCurrencyCode": "<string>",
  "batch": "<string>",
  "createDateTimeUtc": "<dateTime>",
  "createdByUser": "<string>",
  "modifiedDateTimeUtc": "<dateTime>",
  "modifiedByUser": "<string>",
  "segmentId": "<integer>",
  "segment": "<string>",
  "segmentCode": "<string>",
  "segmentUrl": "<string>",
  "mediaOutletId": "<integer>",
  "mediaOutlet": "<string>",
  "grantId": "<integer>",
  "grant": "<string>",
  "grantUrl": "<string>",
  "notes": "<string>",
  "tribute": "<string>",
  "tributeId": "<integer>",
  "tributeType": "<string>",
  "acknowledgeeIndividualId": "<integer>",
  "receiptDate": "<dateTime>",
  "receiptDateFormatted": "<string>",
  "contactPassthroughId": "<integer>",
  "contactPassthroughUrl": "<string>",
  "contactIndividualId": "<integer>",
  "cashAccountingCode": "<string>",
  "giftAskId": "<integer>",
  "contactMembershipId": "<integer>",
  "giftDesignations": [
    {
      "id": "<integer>",
      "projectId": "<integer>",
      "project": "<string>",
      "projectCode": "<string>",
      "externalAccountingCode": "<string>",
      "projectType": "<string>",
      "projectLocation": "<string>",
      "projectUrl": "<string>",
      "amountDesignated": "<double>",
      "display": "<string>"
    },
    {
      "id": "<integer>",
      "projectId": "<integer>",
      "project": "<string>",
      "projectCode": "<string>",
      "externalAccountingCode": "<string>",
      "projectType": "<string>",
      "projectLocation": "<string>",
      "projectUrl": "<string>",
      "amountDesignated": "<double>",
      "display": "<string>"
    }
  ],
  "giftPremiums": [
    {
      "id": "<integer>",
      "premiumId": "<integer>",
      "premium": "<string>",
      "premiumUrl": "<string>",
      "quantity": "<integer>",
      "display": "<string>"
    },
    {
      "id": "<integer>",
      "premiumId": "<integer>",
      "premium": "<string>",
      "premiumUrl": "<string>",
      "quantity": "<integer>",
      "display": "<string>"
    }
  ],
  "pledgePayments": [
    {
      "id": "<integer>",
      "expectedPaymentDate": "<dateTime>",
      "expectedAmount": "<double>",
      "giftId": "<integer>",
      "actualAmount": "<double>"
    },
    {
      "id": "<integer>",
      "expectedPaymentDate": "<dateTime>",
      "expectedAmount": "<double>",
      "giftId": "<integer>",
      "actualAmount": "<double>"
    }
  ],
  "recurringGiftPayments": [
    {
      "id": "<integer>",
      "gift": {
        "id": "<integer>",
        "contactId": "<integer>",
        "giftDate": "<dateTime>",
        "amount": "<double>"
      },
      "expectedAmount": "<double>",
      "expectedPaymentDate": "<dateTime>",
      "dismissPaymentDate": "<dateTime>",
      "fulfillPaymentDate": "<dateTime>"
    },
    {
      "id": "<integer>",
      "gift": {
        "id": "<integer>",
        "contactId": "<integer>",
        "giftDate": "<dateTime>",
        "amount": "<double>"
      },
      "expectedAmount": "<double>",
      "expectedPaymentDate": "<dateTime>",
      "dismissPaymentDate": "<dateTime>",
      "fulfillPaymentDate": "<dateTime>"
    }
  ],
  "giftUrl": "<string>",
  "isPrivate": "<boolean>",
  "isTaxDeductible": "<boolean>",
  "customFields": [
    {
      "name": "<string>",
      "value": "<string>",
      "displayName": "<string>"
    },
    {
      "name": "<string>",
      "value": "<string>",
      "displayName": "<string>"
    }
  ]
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
contactId
string
giftType
string
giftDate
string
amount
string
transactionSource
string
transactionId
string
batch
string
segmentId
string
receiptSegmentId
string
mediaOutletId
string
notes
string
isPrivate
string
receiptDate
string
contactIndividualId
string
contactPassthroughId
string
cashAccountingCode
string
state
string
isTaxDeductible
string
giftAskId
string
passthroughGiftAskId
string
grantId
string
contactMembershipId
string
currencyCode
string
exchangeRate
string
checkNumber
string
creditCardType
string
cryptocoinType
string
transactionHash
string
coinSoldForCash
string
coinAmount
string
dateCoinWasSold
string
coinSaleAmount
string
tickerSymbol
string
numberOfShares
string
iraCustodian
string
stockSoldForCash
string
dateStockWasSold
string
stockSaleAmount
string
nonCashGiftTypeId
string
nonCashGiftType
string
description
string
nonCashSoldForCash
string
dateNonCashWasSold
string
nonCashOriginalAmount
string
nonCashSaleAmount
string
giftDesignations
object[]
giftPremiums
object[]
pledgePayments
object[]
recurringGiftPayments
object[]
tributeType
string
tributeId
string
tributeDescription
string
acknowledgeeId
string
reversedGiftId
string
customFields
object[]

Response

OK

id
string
transactionSource
string
transactionId
string
contactId
string
contactName
string
contactUrl
string
giftType
string
giftTypeFormatted
string
giftDate
string
giftDateFormatted
string
amount
string
amountFormatted
string
currencyCode
string
exchangeRate
string
baseCurrencyCode
string
batch
string
createDateTimeUtc
string
createdByUser
string
modifiedDateTimeUtc
string
modifiedByUser
string
segmentId
string
segment
string
segmentCode
string
segmentUrl
string
mediaOutletId
string
mediaOutlet
string
grantId
string
grant
string
grantUrl
string
notes
string
tribute
string
tributeId
string
tributeType
string
acknowledgeeIndividualId
string
receiptDate
string
receiptDateFormatted
string
contactPassthroughId
string
contactPassthroughUrl
string
contactIndividualId
string
cashAccountingCode
string
giftAskId
string
contactMembershipId
string
giftDesignations
object[]
giftPremiums
object[]
pledgePayments
object[]
recurringGiftPayments
object[]
giftUrl
string
isPrivate
string
isTaxDeductible
string
customFields
object[]
Last modified on April 24, 2026