Update Unintegrated Grant

Update an unintegrated grant object with the given ID. This can be used to update the status or acknowledgement of the unintegrated grant.

Path parameters

idstringRequired
The unique id of the unintegrated grant. The format should be a v4 UUID according to RFC 4122.

Headers

AuthorizationstringRequired

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

Request

This endpoint expects an object.
statusenumOptional

The status of the grant:

  • Initiated: The grant has been initiated and is ready to be processed
  • Completed: The grant has been completed
Allowed values:
acknowledgedAtdatetimeOptional
The date and time the grant was acknowledged by the nonprofit. This is useful for nonprofits to indicate when they have received and processed the grant. Expressed in ISO 8601 format.

Response

OK
idstringformat: "uuid"
The unique identifier for the object
workflowSessionIdstringformat: "uuid"
ID of the Connect Workflow Session associated with this grant
fundIdstring
ID of the donor advised fund
amountdouble
The grant amount expressed in units of whole cents
trackingIdstring or null
The tracking ID for the unintegrated grant
createdAtdatetime or null

Time when this object was created; expressed in ISO 8601 format

updatedAtdatetime or null

Time when this object was last updated; expressed in ISO 8601 format

statusenum or null
The status of the unintegrated grant.
Allowed values:
metadatamap from strings to strings or null
A map of arbitrary string keys and values to store information about the object
firstNamestring or null
The donor's first name
lastNamestring or null
The donor's last name
phonestring or null
The donor's phone number
emailstring or null
The donor's email
addressobject or null
notestring or null
An note inputted by the user at submisson
paymentChannel"offline" or nullDefaults to offline

The payment channel for the unintegrated grant. This is useful to know how the grant will be sent. The payment channel for unintegrated grants will always be:

  • offline: Grant was initiated outside of Chariot so we’re unable to confirm how the grant will be sent.
userFriendlyIdstring or nullDeprecated
Often referred to as the "Chariot ID", this is the ID that will be included in the payment from the DAF provider.

Errors