POST
/
v1
/
recommendations
/
pledge-crypto
Create a crypto pledge recommendation
curl --request POST \
  --url https://api.endaoment.org/v1/recommendations/pledge-crypto \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "donorName": "Anonymous Donor",
  "donorIdentity": {
    "firstName": "John",
    "lastName": "Doe",
    "email": "john.doe@example.com",
    "address": {
      "line1": "123 Main Street",
      "line2": "Suite 100",
      "city": "San Francisco",
      "state": "CA",
      "zip": "94105",
      "country": "USA"
    }
  },
  "updateIdentity": true,
  "shareMyEmail": false,
  "collaboratingFundId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "tokenId": 1,
  "inputAmount": "1000000000000000000",
  "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}'
{
  "id": "123e4567-e89b-12d3-a456-426614174000"
}

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
tokenId
number
required

The token id suggested for the donation

Example:

1

​
inputAmount
string
required

The input amount of the token that was given to the entity, in its smallest unit.

Example:

"1000000000000000000"

​
uuid
string<uuid>
required

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

​
donorName
string

Optional donor name to expose to the receiving entity. Not to be confused with donorIdentity which is the PII/tax receipt information of the donor

Example:

"Anonymous Donor"

​
donorIdentity
object

Optional identity information for the donation receipt.

​
updateIdentity
boolean

Whether to update the user's global identity with the provided donation identity.

Example:

true

​
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

Crypto pledge recommendation successfully created

​
id
string
required

The recommendation id

Example:

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