Skip to main content
POST
Create grant recommendation

Authorizations

Authorization
string
header
required

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

Body

application/json
purpose
string
required

Public declaration of this grant's purpose

Maximum string length: 511
Example:

"General operating support"

amountUsdc
string
required

The amount in USDC for the recommendation, in the smallest currency unit (1000000 = 1 USD)

Example:

"100000000"

orgId
string<uuid>
required

ID of the destination organization

offsetFee
boolean
required

Whether the advisor wants to offset the grant fee

Example:

true

uuid
string<uuid>
required

Unique identifier for the recommendation. Generated on the client side to ensure idempotency.

recommender
object

The name of the grant recommender

Example:

"John Doe"

specialInstructions
string

An optional, binding instruction for the use of the transferred assets. The receiving org must accept these instructions.

Example:

"Funds must be used for the specific project X."

subprojectId
string<uuid>

ID of the Subproject targeted by the grant. Must be sponsored by the receiving organization.

shareMyEmail
boolean

Whether the donor wants to share their email with the org

Example:

false

collaboratingFundId
string<uuid>

ID of the fund that the advisor is collaborating with

Response

Donation recommendation successfully created

id
string
required

The recommendation id

Example:

"123e4567-e89b-12d3-a456-426614174000"