Scheduled Payouts

Overview

Scheduled payouts let you schedule token payouts in advance instead of processing them only at the moment they vest or unlock. You can choose a future date and time for paying out one or more vest events and have Coinbase Token Manager trigger the payout at that time (subject to network and account constraints).

Common use cases include:

  • Paying employees or contributors on a specific date

  • Scheduling investor distributions in advance

  • Coordinating payouts around payroll dates or other events

This feature is only available to companies with tokens on Ethereum or EVM‑compatible blockchains, and may not be enabled on all networks.


Feature requirements

Before you can use scheduled payouts:

  • Your account must be on a supported network

    • Scheduled payouts are generally not available on Ethereum mainnet by default.

    • If your account is on Ethereum Layer 1 and you need scheduled payouts, contact the Coinbase Token Manager support team at tm-support@coinbase.com to discuss options.

  • You must have sufficient tokens in escrow

    • Your escrow smart contract balance must be large enough to cover the vest events you want to schedule.

    • If escrow does not have enough tokens when the payout executes, the payout may fail.

  • You must sign the scheduling transaction before the chosen payout time

    • Scheduling a payout requires an on‑chain transaction.

    • You (or your Safe signers, if using a multisig) must sign and execute that transaction before the scheduled payout time.

Step 1 – Open the Payouts page

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

  2. Navigate to your Payouts page.

  3. Review the list of due and upcoming vest events that are eligible for payout.

You can schedule payouts for both currently due and future vest events, as long as you respect vesting and unlock times (see below).


Step 2 – Select vest events to schedule

  1. In the Payouts list, select the rows representing the vest events you want to pay out in a single scheduled transaction.

  2. You can select:

    • Due vest events, and/or

    • Upcoming vest events.

Important ordering rule:

  • You must pay out vest events in chronological order.

  • For example, if a grant has a vest event on January 1, 2025 and another on February 1, 2025, you cannot:

    • Schedule the February 1 vest event for a date earlier than the January 1 event, or

    • Skip an earlier event and only schedule a later one.

Once you have selected all vest events you want to schedule together, click the Review vest events button (or equivalent) at the bottom‑right of the page.


Step 3 – (Optional) Edit token price calculation and tax settings

In the review screen, you can optionally adjust:

  • Token price calculation method

  • Token price value (if using a custom or manual price)

  • Tax withholding rate (if applicable)

To make changes:

  1. Click Edit in the top‑right of the review panel.

  2. Adjust:

    • Token price calculation method

    • Token price used for the payout

    • Tax withholding fields, if needed

  3. Click Save changes to apply updates to the selected vest events.

These settings impact how reporting and cost basis are calculated, but do not change vest quantities themselves.


Step 4 – Proceed to payment

  1. After reviewing and optionally editing event details, click Proceed to payment at the bottom‑right of the page.

  2. You will be taken to the payment confirmation area, where you normally would initiate an immediate payout.

To schedule the payout instead of executing immediately:

  1. Locate the payment button in the bottom‑right.

  2. Click the small chevron (⌄) or dropdown indicator in that button to access scheduling options.


Step 5 – Choose a custom date and time

  1. From the dropdown options, select Custom date and time.

  2. In the date/time picker:

    • Choose the date on which you want the selected vest events to be paid out.

    • Choose the time of day for the payout.

Key points:

  • Time zones

    • The date and time shown are based on your account’s configured timezone.

    • Ensure this timezone matches your organization’s expectations for when payouts should execute.

  • Vesting and unlock timing constraints

    • You cannot schedule a payout before the vest or unlock times of the included events.

    • For example, if:

      • One event vests at March 3, 2024 12:00 UTC, and

      • Another vests at March 5, 2024 03:00 UTC,

      • The earliest allowed scheduled payout time for both together might be March 5, 2024 03:01 UTC.

Once you have selected a valid date and time, confirm your choice.


Step 6 – Schedule the payout (on‑chain transaction)

  1. Click Schedule payment (or the equivalent scheduling action) to create the scheduled payout.

  2. Coinbase Token Manager will prompt your connected wallet to sign an on‑chain transaction that sets up the schedule.

Important:

  • The scheduled payout does not become active until this on‑chain transaction is successfully executed.

  • If you close the window or reject the transaction, the payout will not be scheduled.

For accounts using a Safe (Gnosis) multisig:

  • A transaction will be created that must:

    • Be signed by the required number of Safe owners/signers, and

    • Then be executed from the Safe interface.

  • Ensure all required signers are aware of the scheduled payout and approve within your internal timelines.


Step 7 – Confirm the scheduled payout

After the transaction has been executed on‑chain:

  1. Go to your Transactions or Activity page in Coinbase Token Manager to confirm the scheduling transaction was successful.

  2. You can also view:

    • Your Payout history tab within the Payouts page, which should show the scheduled payout and its future execution time.

If the scheduling transaction fails or is never fully signed/executed:

  • The payout will not be scheduled.

  • You may need to:

    • Retry the scheduling process, or

    • Confirm with your signers that the Safe transaction was approved and executed.

Overview

If you have created a scheduled payout in Coinbase Token Manager and no longer want it to execute, you can cancel it from the Payout history view. This prevents the scheduled payout from running at its planned date and time.

You should cancel a scheduled payout if:

  • The underlying vest events or amounts have changed

  • A stakeholder’s wallet information or eligibility has changed

  • You no longer intend to send that distribution


Step 1 – Go to Payout history

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

  2. Navigate to your Payouts page.

  3. Open the Payout history tab or section.

  4. Locate the entry representing the scheduled payout you want to cancel.

You can usually identify a scheduled payout by its status, scheduled execution time, and the vest events it includes.


Step 2 – Cancel the scheduled payout

  1. In the Payout history list, select or open the scheduled payout you want to cancel.

  2. Click Cancel (or the equivalent cancel action next to that payout).

  3. When prompted, confirm by clicking Cancel payout.

After confirmation:

  • The scheduled payout will be marked as canceled.

  • It will no longer execute at the scheduled time.

  • The underlying vest events remain in the system and can be included in a new payout or scheduled payout later if needed.

If your account uses additional on‑chain approvals or multisig flows (for example, a Safe wallet), make sure that:

  • Any associated transactions are not executed after you cancel the payout in Coinbase Token Manager.

  • Your internal signers are aware that the scheduled payout has been canceled.

If you need immediate assistance, please contact our support team directly at:

tm-support@coinbase.com

References to third-party services are provided solely for your convenience and do not constitute an endorsement, approval, or recommendation by Coinbase. Coinbase does not control and is not responsible for any third-party services, websites, or content.

If you don't see what you're looking for in our support documentation, you can request a resource to be made by our support team using this form.