---
title: "Create a new client hub."
method: POST
path: "/v1/hubs"
tags: ["hubs"]
---

# Create a new client hub.

`POST /v1/hubs`

Creates a new hub associated with your account. Hubs represent physical locations (such as stores or warehouses) from which parcels can be picked up or delivered to.

## Request body

- object — Request body for creating a new client hub.
  - `external_id` string, required — A unique identifier you define to reference this hub. This ID is used in parcel pickup and drop-off configurations.
  - `address` string, required — Full street address of the hub.
  - `location` object — A geographic coordinate expressed as latitude and longitude.
    - `lat` number, float, required — Latitude in decimal degrees.
    - `lon` number, float, required — Longitude in decimal degrees.
  - `instructions` string — Additional instructions for drivers arriving at this hub (e.g. access codes, gate numbers).
  - `contact` object — Primary contact person at this hub.
    - `name` string — Full name of the contact person.
    - `phone` string — Phone number of the contact person.

## Response `200`

Hub created successfully.

- object — Response returned after successfully creating a hub.
  - `id` string — System-generated ID of the newly created hub.

## Other responses

- `401` — Unauthorized. Missing or invalid authentication token.

---

[API](https://skmtc.dev/cabify/apis/ride-hailing-api.md) · [All operations](https://skmtc.dev/cabify/apis/ride-hailing-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cabify/ride-hailing-api/revisions/8da1cb1270df/schema)