Creating Grants - Toku Docs

Overview

Create token grants to award equity to your team. Each grant specifies the recipient, token amount, vesting schedule, and grant configuration.

Creating a Single Grant

Dashboard
API

Navigate to Grants

Click Grants in the sidebar.

Click New Grant

Select New Grant to open the creation form.

Select grant configuration

Choose from your configured grant types (RTU, RTA, TPA, or TOKEN_BONUS). See Grant Configurations to set these up.

Enter grant details

Recipient — Select or search by email
Grant amount — Number of token units
Grant name — Descriptive name
Grant date — When the grant was issued
Vesting start date — When vesting begins
Vesting schedule — Select a template or configure custom
Tags — Optional categorization

Review and create

Review the summary and click Create Grant.

Use the Add Single Grant endpoint:

curl -X POST https://app.toku.com/api/tokuApi/v1/addSingleGrant \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "x-role-type: CLIENT_ORG_ADMIN" \
  -H "Content-Type: application/json" \
  -d '{
    "grantName": "Q1 2026 Token Grant - Jane Smith",
    "grantConfigurationID": "config-uuid",
    "grantAmount": 50000,
    "recipientID": "role-in-org-uuid",
    "vestingStartDate": "2026-01-01T00:00:00.000Z",
    "vestingFrequencyType": "MONTHLY",
    "vestingPeriods": 48,
    "vestingCliffPeriods": 12,
    "vestingCliffPercentage": 25,
    "tags": ["engineering", "2026"]
  }'

For new hires, use Create Grant for New Hire to create the user and grant in one call.

Grant Status Lifecycle

Status	Description
`PENDING`	Created, awaiting recipient acceptance
`ACCEPTED`	Accepted and actively vesting
`COMPLETED`	All vesting periods complete
`TERMINATED`	Terminated early
`MARKED_FOR_FUTURE_TERMINATION`	Termination scheduled for future date
`PAUSED`	Vesting temporarily paused
`REJECTED`	Declined by recipient

Bulk Grant Creation

For multiple grants, use Bulk Upload:

Navigate to Bulk Upload → Grants tab
Download the CSV template
Fill in grant details for each recipient
Upload and review
Submit

Updating Grants

Edit pending grants before they’re accepted:

Change token amount, vesting dates, or tags
Update grant configuration
Modify recipient assignment

After acceptance, use Terminate Grant to end a grant, or create a new grant with updated terms.

Next Steps

Grant Configurations

Set up grant type templates

Vesting Schedules

Configure vesting schedules

Terminations

Handle employee departures

Bulk Upload

Import grants via CSV

​Overview

​Creating a Single Grant

​Grant Status Lifecycle

​Bulk Grant Creation

​Updating Grants

​Next Steps

Grant Configurations

Vesting Schedules

Terminations

Bulk Upload

Overview

Creating a Single Grant

Grant Status Lifecycle

Bulk Grant Creation

Updating Grants

Next Steps