> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.chrt.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.chrt.com/_mcp/server.

# Marketplace

> How couriers use the chrt bidding marketplace — create listings, choose a response mode, manage the bid thread, and award the job.

The **Marketplace** is chrt's bidding venue. Instead of assigning a job to one
specific driver, you create a **listing** from a task group and send it to a
group of drivers, partner couriers, or both. Recipients see the listing in
their bidding inbox and respond based on the **response mode** you pick —
straight accept, first-accept-wins, or back-and-forth negotiation. This page
covers the full listing-and-bidding flow from your side as the lister.

## Before you start

* Listings come from staged task groups — see
  [Creating Orders](/couriers/creating-orders) and
  [Dispatching](/couriers/dispatching) for the job-creation side first.
* Bidding is provider-mode only. You see the **Bidding** tab in the sidebar
  when your org is in Provider mode and your role is admin or higher.
* To list a job, you need at least one of: connected drivers on your org,
  connected partner couriers in your network, or a bidding group set up.

## 1. Open the bidding hub

Open [chrt.com/bidding](https://chrt.com/bidding). The page has two tabs:

| Tab       | What's there                                                                             |
| --------- | ---------------------------------------------------------------------------------------- |
| **Inbox** | Listings other orgs (or other dispatchers in your org) have sent your way. Bid on these. |
| **Sent**  | Listings you've created from your own task groups. Manage and award these.               |

The data table on each tab is filterable by **status** (open, awarded,
cancelled, expired), **type**, **created date**, and **last edited**. Click
any row to open the listing detail.

## 2. Create a listing from a task group

Listings are created from the order page on a specific task group, not from
the bidding page directly.

1. Open the order at [chrt.com/orders](https://chrt.com/orders).
2. On the task group you want to list, open the action menu and click
   **Create listing**.
3. In the **Create listing** dialog, fill in:
   * **Description** — what recipients see about the job (origin, destination,
     timing, cargo highlights).
   * **Audience** — **Drivers**, **Couriers** (other provider orgs), or both
     via a bidding group.
   * **Response mode** — see step 3 below.
   * **Pro-forma line items** — your proposed pricing for the job, line by
     line. Recipients see the total (and optionally the line items) when they
     view the listing.
   * **Share line items** — toggle on if you want recipients to see the
     per-line breakdown, off if you only want them to see the total.
   * **Private notes** — internal-only context for your dispatch team. Bidders
     never see this.
4. Pick **participants** — the specific drivers, partner couriers, or
   bidding groups who should see the listing.
5. Click **Create**.

## 3. Pick the right response mode

The response mode determines how recipients interact with your listing.

| Mode                  | Use when                                                                          | What recipients see                                                                                                 |
| --------------------- | --------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| **Dispatch directly** | You've already picked the driver and want a clear accept-or-deny.                 | A dispatch request. Accept assigns the order immediately; deny only if they can't take it. (Drivers audience only.) |
| **First accept wins** | You're broadcasting to a few drivers or couriers and want the fastest yes to win. | The first acceptance assigns the order. Everyone else's response auto-closes.                                       |
| **Bid and negotiate** | You expect a back-and-forth on price.                                             | Recipients can submit a bid, send a counter, or accept the current offer. You review and confirm the winner.        |

> **Note**
>
> **Dispatch directly** is the default for driver-audience listings — it's
> the closest equivalent to direct assignment with a clean audit trail. Use
> **First accept wins** when you'd be happy with any of three or four drivers
> and want speed. Use **Negotiation** for jobs where price isn't fixed.

## 4. Manage the bid threads

Open any listing in your **Sent** tab to see the detail page:

* **Listing summary** — description, audience, response mode badges, status.
* **Pricing summary** — the pro-forma total and (if shared) the line items.
* **Participants** — who you sent it to. Add or remove participants while the
  listing is open.
* **Bid threads** — one thread per bidder. Each thread shows the bidder, the
  current offer, and the conversation.

From a bid thread you can:

* **Accept** the bidder's current offer — moves toward awarding the job to
  them.
* **Counter** with a revised price. The bidder sees the counter and can
  accept, counter again, or withdraw.
* **Deny** the thread — the bidder is removed from the listing without the
  listing being cancelled.

The listing auto-refreshes every 20 seconds while you have it open so you
don't have to reload to see new bids.

## 5. Award the job

How awarding happens depends on the response mode:

* **Dispatch directly** — the moment the driver accepts, the order is
  assigned to them and the listing closes. No additional confirm step.
* **First accept wins** — the moment the first recipient accepts, the order
  is assigned and all other open threads close automatically.
* **Bid and negotiate** — when both sides have accepted a price (or you
  accept their bid), you click **Confirm award** to finalize. The order is
  assigned to the bidder at the agreed price.

> **Warning**
>
> Awarding assigns the task group to the winner immediately. If the listing
> was sent to a partner courier, the task group leaves your org and lives on
> their org. Make sure the rate sheet on the listing matches what you want
> to bill before you confirm.

## 6. Cancel or edit a listing

While a listing is **Open**:

* **Edit** — change the description, pricing, participants, or internal
  notes. Bidders see the updated listing on their next refresh.
* **Cancel listing** — closes the listing without awarding. Bidders see it
  marked as cancelled and can't take any further action. Use the
  cancellation when the underlying job is no longer needed or you want to
  re-list with a different shape.

Cancellation is irreversible — you'd need to create a new listing if you
change your mind.

## How to know it worked

* The listing appears in your [Sent tab](https://chrt.com/bidding) with
  status **Open**.
* Each participant gets a notification (in-app and email, depending on
  their settings) that there's a new listing in their inbox.
* Bid threads populate as recipients respond.
* After award, the task group on the underlying order shows the assigned
  driver or partner courier, and the listing status flips to **Awarded**.

## If something looks different

* **The Bidding tab isn't in your sidebar.** Confirm you're in **Provider
  mode** at the top of the app and that your role is admin or higher.
* **No participants to pick from.** Drivers audience needs drivers on your
  org (see [Drivers](/couriers/drivers)); couriers audience needs connected
  partner couriers (see [Connections](/couriers/connections)).
* **A bidder's thread shows "Listing unavailable."** They aren't a
  participant — add them to the listing's participants from the detail page.
* **The listing auto-closed before anyone accepted.** Check the listing's
  status — **First accept wins** closes the moment the first acceptance
  lands, even if other bidders were close.
* **You can't see the per-line pricing on a listing you received.** The
  lister has **Share line items** turned off. You see the total only.
* Contact [hi@chrt.com](mailto:hi@chrt.com) if a listing looks wrong.

## Related guides

* [Dispatching](/couriers/dispatching) — direct assignment (the non-listing
  path to getting a driver on a job).
* [Connections](/couriers/connections) — connect with partner couriers so you
  can list to their orgs.
* [Drivers](/couriers/drivers) — manage the driver roster you list to.
* [Creating Orders](/couriers/creating-orders) — the order side; listings
  come from task groups on these orders.
* [Orders](/docs/concepts/orders) — the task group model listings attach to.