---
title: "Crear ciudad | Documentación de Ordering.co"
description: "Usa POST /countries/{country}/cities para crear una ciudad bajo un país."
canonical: https://docs.ordering.co/es/api-reference/guides/create-city/
---

# Crear ciudad

> **API operation:** [Abrir la operación en la Referencia de la API](https://docs.ordering.co/es/api-reference/#tag/countries/POST/countries/{country}/cities)

Usa `POST /countries/{country}/cities` para crear una ciudad bajo un país. La operación pública actual es `City.register`.

El comportamiento descrito restringe esta operación a los niveles de rol `0` y `1`. Copia el valor `country` de la ruta en `country_id` antes de validar la solicitud. La Referencia de la API enumera `name` y `country_id` como campos obligatorios, aunque la ruta también proporciona el país.

Los campos opcionales del comportamiento descrito incluyen `administrator_id` y `enabled`. Consulta la operación para los esquemas completos de solicitud, respuesta y error.

## Ejemplo de SDK heredado

```javascript
const response = await ordering.countries(countryId).cities().save(data)
```

El método del SDK que se muestra es `cities()`; confirma el paquete y la versión del SDK antes de usarlo.

## Referencia de OpenAPI

**Operación:** `POST /countries/{country}/cities`

**Parámetros de ruta**

| Nombre    | Tipo    | Obligatorio | Descripción |
| --------- | ------- | ----------- | ----------- |
| `country` | integer | Sí          | —           |

**Campos del cuerpo de la solicitud**

| Nombre             | Tipo            | Obligatorio |
| ------------------ | --------------- | ----------- |
| `administrator_id` | integer \| null | No          |
| `country_id`       | integer         | Sí          |
| `enabled`          | boolean         | No          |
| `name`             | any             | Sí          |

**Respuestas**

| Código | Descripción                                                                                                                                                                                                                                                                        |
| ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 200    | Respuesta exitosa. El contenido de `result` varía según la operación y se devuelve como JSON.                                                                                                                                                                                      |
| 400    | Respuesta de error (error=true). Los errores de validación y de negocio comparten este código.                                                                                                                                                                                     |
| 401    | Respuesta de error: sesión ausente, inválida, o nivel de usuario fuera de los permitidos. Respuesta de error: el proyecto no existe o no tiene una suscripción activa.                                                                                                             |
| 404    | Respuesta vacía: la versión de API solicitada no está admitida.                                                                                                                                                                                                                    |
| 429    | Envelope de error: se excedió un límite de consumo del proyecto (o el sujeto está baneado). Lleva Retry-After y X-RateLimit-Limit/Remaining/Reset/Scope/Key.                                                                                                                       |
| 500    | Respuesta de error: falló la búsqueda o inicialización del proyecto.                                                                                                                                                                                                               |
| 503    | Envelope de error: la aplicación está temporalmente en mantenimiento. Envelope de error: el proyecto está temporalmente en mantenimiento, o los límites de consumo no se pudieron evaluar y el límite aplicable está configurado con on\_error = closed (cabecera Retry-After: 1). |

[Abrir esta operación en la Referencia de la API](https://docs.ordering.co/es/api-reference/#tag/countries/POST/countries/{country}/cities)