---
title: "Create a dispatch location"
method: POST
path: "/v1/dispatch_locations"
---

# Create a dispatch location

`POST /v1/dispatch_locations`

## Headers

- `X-Metric-Units` boolean

## Request body

- object
  - `name` string — Specify the name of the location for which you want create a dispatch.
  - `vendor_id` string — Specify the external vendor ID for the new location.
  - `address1` string — Specify the primary address of the location.
  - `address2` string — Specify the address line 2 for the location.
  - `city` string — Enter the name of the city where the dispatch is located at.
  - `state` string — Enter the name of the state of the dispatch location.
  - `zip` string — Enter the ZIP code of the dispatch location.
  - `country` string — Enter the country where the dispatch location is existing.
  - `lat` number, float — Enter the latitude coordinates of the dispatch location.
  - `lon` number, float — Enter the longitude coordinates of the dispatch location.
  - `arrive_radius` integer — Radius of area when arriving at a stop for auto detection. Value should be in meters if X-Metric-Units is not specified or true. Value should be in foot if X-Metric-Units is false.
  - `depart_radius` integer — Radius of area when departing from a stop for auto detection. Value should be in meters if X-Metric-Units is not specified or true. Value should be in foot if X-Metric-Units is false.
  - `phone` string — Enter the phone number of the location.

## Response `201`

201

- object
  - `dispatch_location` object
    - `id` integer
    - `vendor_id` string
    - `lat` integer
    - `lon` integer
    - `name` string
    - `address1` string
    - `address2` string
    - `city` string
    - `state` string
    - `zip` string
    - `country` string
    - `arrive_radius` integer
    - `depart_radius` integer
    - `phone` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/gomotive/apis/motive.md) · [All operations](https://skmtc.net/gomotive/apis/motive/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gomotive/motive/versions/c71780e497f5/schema)