Manage stakeholders

This article walks through how to create a new stakeholder in Coinbase Token Manager. Stakeholders are the individuals or entities (employees, advisors, investors, contractors, etc.) who receive token grants from your organization. Each stakeholder profile holds the recipient's identity, wallet address, source wallet(s) for their grants, and their permission level in your account.

You must be signed in as an admin with permission to create stakeholders to complete this flow.

Step 1 — Open the Create stakeholder flow

1. Sign in to Coinbase Token Manager at tokenmanager.coinbase.com.

2. In the top navigation, select the Stakeholders tab.

3. In the top right of the Stakeholders page, select: Create stakeholder.

Step 2 — Enter stakeholder details

Provide the following information about the stakeholder:

• First name (required)

• Last name (required)

• Stakeholder type (required) — for example, Employee, Investor, Advisor, Contractor, or Community. This is set at the stakeholder level and applies across all of their grants.

• External ID (optional) — your organization's internal identifier for the stakeholder (e.g., HRIS or payroll ID). Useful for reporting and reconciliation.

• Location details (optional) — Street Address, City, State/Province, Country, Zipcode.
  

Select Continue

Step 3 — Add wallet details

A wallet address is required for stakeholders to receive tokens. Select one of the three options below.

Option 1 — Generate a wallet address

Select this option to automatically generate a wallet address for the stakeholder. The system creates a wallet whose private key is associated with the email address you provide. The stakeholder will log in to Coinbase Token Manager using that email.

• Email (required): Enter the stakeholder's email address.

Note: The private key for the generated wallet is linked to this email address. This email becomes the stakeholder's primary login method for Coinbase Token Manager. If the email needs to be changed later, follow the Update the email address of a stakeholder with a platform-generated wallet flow listed below.

Option 2 — Manually enter a wallet address

Select this option if the stakeholder has already provided their preferred wallet address. Paste the wallet address into the field and confirm it is on the correct network for your account.

Option 3 — Request wallet address from stakeholder

Select this option if you prefer the stakeholder to provide their own wallet address. The stakeholder will receive an email invite prompting them to submit their wallet. Until they do, the stakeholder profile will remain in a pending wallet state and no payouts can be processed to them.

For guidance on collecting wallet addresses at scale, see What's the correct order of operations to collect wallet addresses from stakeholders?

Select Continue.

Step 4 — Add source wallets

Source wallets define where the stakeholder's token grants will be paid out from.

• Add one or more source wallets that should be used to fund this stakeholder's grants.

• If no source wallets are added, grants for this stakeholder will default to your company treasury.

Select Continue.

Step 5 — Set the permission level

Choose the permission level that determines what this stakeholder can see and do in Coinbase Token Manager:

• Stakeholder — Can only view the token grants issued to them.

• Admin — Can draft, view, and edit token grants, but cannot publish them.

• View only — Can view everything an admin can view, but cannot make any changes.

• Owner — Has full access to the account and can execute all transactions.

Select Save to finalize the stakeholder profile.

What happens next

• The new stakeholder appears on the Stakeholders page in the Active tab.

• If you selected Generate a wallet address or Request wallet address from stakeholder, the stakeholder receives an email invite to activate their account.

• You can now create a token grant for this stakeholder.
  
  

Use this when you need to replace the wallet address associated with a stakeholder’s token grant.

Steps

1. Sign in to Coinbase Token Manager as an admin.

2. Go to your token grants or vesting plans page.

3. Find the token grant whose wallet address needs to be changed.

4. On the far right of that grant’s row, open the more actions menu (three dots) and choose Change wallet address.

5. Enter the new wallet address and select Save.

6. Confirm the success message indicating the wallet address was updated.

On‑chain and multisig behavior

• For on‑chain accounts (smart contract / escrow):

  • You may be prompted to sign and execute a blockchain transaction in your connected wallet (for example, MetaMask, Rabby).

• For MPC or multisig owner wallets (for example, Safe, Fireblocks):

  • You may need to propose and approve a transaction in your custody or multisig interface and meet your quorum before the wallet change takes effect.

Use this when a stakeholder’s role with your organization changes (for example, employee to advisor, or contractor to investor).

Steps

1. Sign in to Coinbase Token Manager.

2. Navigate to the Stakeholders page.

3. In the Active tab, locate the stakeholder whose relationship type you want to update.

4. On the right side of the stakeholder’s row, open the more actions menu (three dots) and select Edit stakeholder.

5. Find the Relationship field and choose the new relationship type from the dropdown.

6. Select Save to apply the change.

Use this when a stakeholder record is no longer needed and can safely be removed (for example, test data or a profile with no active grants).

Steps

1. Sign in to Coinbase Token Manager.

2. Go to the Stakeholders page.

3. Locate the stakeholder you want to delete.

4. On the right side of their row, open the more actions menu (three dots) and select Delete stakeholder.

5. In the confirmation dialog, select Delete to remove the stakeholder.

Note: If the stakeholder has active grants or history, consider archiving or updating them instead of deleting, per your internal policies.

Use this when a stakeholder requests a name update (for example, legal name change, updated entity name, or correction of a typo).

Steps

1. Sign in to Coinbase Token Manager.

2. Navigate to the Stakeholders page.

3. Find the stakeholder whose name you want to update.

4. Open the more actions menu (three dots) on the right side of the row and select Edit stakeholder.

5. Update the name fields you need to change (for example, first name, last name, organization name).

6. Select Save.

After saving, the updated stakeholder name will be reflected across all token grants and views where that stakeholder appears.

Use this when you need to update many stakeholders at once (for example, updating external IDs, departments, or other profile attributes).

Steps

1. Sign in to Coinbase Token Manager.

2. Go to the Stakeholders page.

3. Select the Import or Bulk update option.

4. Export the current stakeholder data to CSV (for example, Export stakeholders CSV).

5. Open the CSV file in your spreadsheet editor and:

   • Update stakeholder information as needed (for example, names, emails, external IDs).

   • Do not change column headers unless instructed.

6. Save the updated file as a CSV.

7. Return to Coinbase Token Manager and choose Select file (or equivalent).

8. Upload your edited CSV.

9. Follow the prompts (for example, Next, then Bulk update) to confirm.

Once the upload completes successfully, stakeholder records will be updated to match the data in your CSV.

Stakeholders can request wallet address changes directly from their own view. Admins must approve or reject these requests before any address changes take effect.

How you are notified

• When a stakeholder submits a wallet change request, admins receive an email notification with a link to view the request.

• You can also see pending requests:

  • In the Activity feed (bell icon in the top navigation, with a red dot when there are new items).

  • On the Stakeholders page, where a banner may highlight pending wallet change requests.

Steps to approve or reject

1. Sign in to Coinbase Token Manager.

2. Open the request:

   • From the email, click View request to go directly to the request in the app, or

   • From within the app:

     • Click the bell icon to open the Activity feed and select the request, or

     • Go to the Stakeholders page and use any visible banner or list of requests to open it.

3. Review the request details, including:

   • The current wallet address

   • The requested new wallet address

4. Choose Approve or Reject.

What happens next

• If you approve:

  • The stakeholder receives an email confirmation.

  • The new wallet address becomes active and available for use in Coinbase Token Manager.

• If you reject:

  • The stakeholder receives an email informing them the change was not approved.

  • The existing wallet address remains in place.

  • The request status is updated in your Activity feed.

Use this flow when a stakeholder has a Coinbase Token Manager–generated wallet and you need to change the email address associated with their profile and grants.

Because the wallet is generated and linked at the stakeholder level, the recommended approach is to create a new profile and move the grant.

Steps

1. Create a new stakeholder profile:

   • Go to the Stakeholders page and select Create stakeholder.

   • Choose the option to generate a platform wallet address.

   • Enter the new email address for the stakeholder.

   • Save the new profile.

2. Move their active grant to the new email:

   • Go to your token grants or vesting plans page.

   • Find the active grant associated with the old email.

   • Duplicate that grant into your drafts and assign it to the new stakeholder profile (with the new email).

3. Clean up old data:

   • Once you have verified the duplicated draft looks correct, delete or archive the previous active grant tied to the old email.

   • Publish the new draft grant associated with the new email address.

4. Optional profile cleanup:

   • You may:

     • Delete the old stakeholder profile, or

     • Rename it (for example, append “– old” to the name) to indicate it is no longer active.

After these steps, the stakeholder can log in with their new email and see the updated grants linked to their platform‑generated wallet.

Use this when you need to add an email to a stakeholder who did not have one before, or update the email address on an existing stakeholder profile (for example, a change in corporate email).

Steps

1. Go to the Stakeholders page in Coinbase Token Manager.

2. Find the stakeholder whose email you want to add or update.

3. On the right side of their row, open the more actions menu (three dots) and choose Edit stakeholder.

4. In the Email field:

   • Add a new email address if it was blank, or

   • Replace the existing email with the new address.

5. Select Save to apply the change.

Notes and troubleshooting

• If you do not see the Edit stakeholder option:

  • You may not have permission to edit stakeholder profiles.

  • Contact your account administrator to request the appropriate role or permissions.

• If the email format is rejected:

  • Confirm it is a valid email address (for example, no spaces, includes “@” and a domain).

  • Correct any typos and try saving again.