Adding a new gift with gift subtype

David Zeidman · May 13

I am able to add a new gift using the gift v2 api with the following endpoint:

https://api.sky.blackbaud.com/gft-gifts/v2/gifts

However, the gift subtype that I added does not appear. It neither appears in the UI nor when I pull the gift back from the API.

My payload is as follows:

{ "gift_date": "2026-05-11T00:00:00", "amount": { "value": 1.5 }, "sub_type": { "name": "Monetary", "id":2523 }, "gift_post_status": "DoNotPost", "gift_type": "OneTime", "gift_splits": [ { "fund_id": "68", "amount": { "value": 1.5 }, "campaign_id": "13", "appeal_id": "30" } ], "payments": [ { "method": "Cash" } ], "acknowledgements": [ { "status": "NotAcknowledged" } ], "receipts": [ { "receipt_status": "Receipted", "date": "2026-05-11" } ], "constituent": { "id": "25196" } }

I have tried both with and without the gift subtype id. I have also tried it as
"sub_type": "Monetary"

even though the docs show it as an object that I used at first.

Has anybody else managed to add this or is this a bug?

Alex Wong · May 13

I was able to add gift subtype no problem using "name" only in the gift_subtype property.

Did you ensure the name (table entry long description) is an active one in the environment you are running this in?

{

    "amount": {

        "value": 120

    },

    "gift_type": "OneTime",

    "gift_splits": [{

        "id": null,

        "amount": {

            "value": 120

        },

        "fund_id": "4689"

    }],

    "constituent": {

        "id": "458424"

    },

    "gift_date": "2026-01-01T12:00:00Z",

    "gift_subtype": {

        "name": "BA_BB_ML4404"

    }

}