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

# Create a new client hub.

`POST /v1/hubs`

## Request

- Base URL: `https://logistics.api.cabify-sandbox.com`
- URL: `https://logistics.api.cabify-sandbox.com/v1/hubs`
- Auth: HTTP bearer

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.
- `429`: Too many requests. This API is rate limited per account and per endpoint. A 429 is an expected condition rather than a failed request: back off and retry it. The limits are not the same for every endpoint and can change, so handle the status instead of hard-coding a rate. See the Limits and reliability guide.

---

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