Gift Note 403 forbidden error

James Benson

All my API calls work except when trying to create a gift note, I receive a 403 forbidden error message from both my code and the API docs example.

This is the endpoint Im calling

The request schema looks like this:

{
"gift_id": 356,
"date": {
"d": 15,
"m": 12,
"y": 2018
},
"summary": "Registration fees",
"text": "The registration fees were paid by Mrs. Hernandez.",
"note_type_id": 1122,
"author": "Supervisor"
}

It's a valid request as far as I can see and other API calls work during the same request to the server (create gift, create constituent etc) but the create gift note fails for some reason. It does say it's still in preview mode so perhaps there is a bug with this API endpoint?

Alex Wong

@James Benson

A few clarification and issues:

NXT Data Integration endpoint requires you to be RE NXT environment admin, are you?

Did you use the schema exactlyl like you showed it? I can see that it is exactly what's on the API reference documentation page, if it is exactly what you used, then a few problems:

• gift_id of 356, you have a gift in your RE NXT environment with that gift id?
• note_type_id of 1122, does your RE NXT environment have a gift notepad type of ID 1122?

403 error usually means you do not have right to do something, so the environment admin is 1 problem while the other is maybe there's a database security option to restrict anyone from creating a gift note pad of the type you are trying to create and you are in the restricted list. (though, if you are admin on both webview and database view, you should be ok)

James Benson

@Alex Wong
I'm only a contributor to the application, although it does say I have full access to the environment.

It doesn't say in the docs what note_type_id actually is or where to get this value from, so don't know really.

Ashley Moose

@James Benson Note type ID is the ID of the Gift Notepad Type table entry.

You can use the Get Code Table List endpoint to identify the ID of the Gift Notepad Type table.

Then use that ID in the Get Table Entries List endpoint to identify the ID of the specific note type.

Alex Wong

@James Benson

A lot depends on what is setup on your “application” and who's credential is used to run the API endpoints. Are you using Power Automate? or you using some or programming language to issue the APi calls.

Whoever (you or someone else in your org) setup the application and authentication will need to be a RE NXT environment administrator in order to issue NXT Integration API calls, including the one mentioned by Ashley to get the Gift Notepad Type ID.

If you validated that the authentication token is through an environment administrator, then issue this API call as mentioned by Ashley (5045 is the code table responsible for storing gift notepad type, this is a system code table so 5045 will be same for ALL RE NXT instance).

You should get back the various gift notepad type's ID, which is what is needed to create gift note.

If I want to create a gift note that has the Type=Gift Narrative, I will need to provide “note_type_id”: 1757 to the create gift note API endpoint. 1757 is specific to my org's RE NXT instance, your RE NXT will definitely be different number.