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

# Create dispatch strategy

`POST /v1/options_group`

## Request

- Base URL: `https://api.sandbox.usenash.com`
- URL: `https://api.sandbox.usenash.com/v1/options_group`
- Auth: none declared

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
  - `preventReassignmentPriceIncrease` boolean, 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
  - `preventReassignmentPriceIncrease` boolean, nullable
  - `costSplitStrategy` 'none' | 'price' | 'percentage', nullable
  - `costSplitMaxPercentage` integer, nullable
  - `costSplitMaxFixedPriceCents` integer, nullable
  - `smartReassignment` boolean, nullable

## Other responses

- `422`: Unprocessable Content

---

[API](https://skmtc.dev/nash/apis/nash-api.md) - [All operations](https://skmtc.dev/nash/apis/nash-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nash/apis/nash-api/revisions/e3713837c5c9?raw)