---
title: "Create dispatch strategy"
method: POST
path: "/v1/options_group"
tags: ["Dispatch Strategies"]
---

# Create dispatch strategy

`POST /v1/options_group`

Create a new dispatch strategy (options group) with provider selection rules, fallback logic, and quoting configuration.

## Request body

- OptionsGroupInputMixin — Common schema for inputting a dispatch strategy.
  - `id` string, nullable
  - `label` string, required
  - `allowedProviders` string[], nullable
  - `enableAutoDispatch` boolean, nullable
  - `providerSelectionStrategy` 'lowest_price' | 'preferred_order', nullable
  - `reassignOnFailure` boolean, nullable
  - `enableMaxDeliveryFee` boolean, nullable
  - `maxDeliveryFeeCents` integer, nullable
  - `costSplitStrategy` 'none' | 'price' | 'percentage', nullable
  - `costSplitMaxPercentage` integer, nullable
  - `costSplitMaxFixedPriceCents` integer, nullable
  - `smartReassignment` boolean, nullable

## Response `200`

OK

- OptionsGroupInputMixin — Common schema for inputting a dispatch strategy.
  - `id` string, nullable
  - `label` string, required
  - `allowedProviders` string[], nullable
  - `enableAutoDispatch` boolean, nullable
  - `providerSelectionStrategy` 'lowest_price' | 'preferred_order', nullable
  - `reassignOnFailure` boolean, nullable
  - `enableMaxDeliveryFee` boolean, nullable
  - `maxDeliveryFeeCents` integer, nullable
  - `costSplitStrategy` 'none' | 'price' | 'percentage', nullable
  - `costSplitMaxPercentage` integer, nullable
  - `costSplitMaxFixedPriceCents` integer, nullable
  - `smartReassignment` boolean, nullable

## Other responses

- `422` — Unprocessable Content

---

[API](https://skmtc.net/usenash/apis/nash-api.md) · [All operations](https://skmtc.net/usenash/apis/nash-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/usenash/nash-api/revisions/09a23a95889b/schema)