---
title: "Create Advert"
method: POST
path: "/api/integrazu/adverts/create"
tags: ["Integrazu Adverts"]
---

# Create Advert

`POST /api/integrazu/adverts/create`

Create a new vehicle advert in Integrazu.

**Integrazu Endpoint:** `POST /api/vehicles/adverts/create`

Args:
    advert_data: Complete advert payload with vehicle specifications
    brand_id: Brand ID to fetch the correct Integrazu token

Returns:
    Created advert response with advert ID

Example payload:
```json
{
    "brand_id": 51,
    "model_id": 2018,
    "fuel_id": 16,
    "category_id": 8,
    "color_id": 2,
    "gearbox_id": 1,
    "mileage": 35000,
    "power": 116,
    "engine_capacity": 1197,
    "first_registration_month": 3,
    "first_registration_year": 2017,
    "price": 19500,
    "registration": "42-XI-26",
    "location_id": "41",
    "features": [428, 287, 447]
}
```

## Query parameters

- `brand_id` integer, required — Z_Brands.id for token lookup

## Headers

- `x-api-token` string, nullable

## Request body

- IntegrazuAdvertCreate — Complete model for creating a vehicle advert in Integrazu. Integrazu uses catalog reference IDs for all vehicle attributes. Boolean flags use Union[int, str] to support both 1 or "" format.
  - `brand_id` integer, required — Integrazu brand ID
  - `model_id` integer, required — Integrazu model ID
  - `fuel_id` integer, required — Integrazu fuel type ID
  - `section_id` integer, nullable — Vehicle section ID (cars, motorcycles, etc.)
  - `category_id` integer, nullable — Category ID (SUV, Sedan, etc.)
  - `color_id` integer, nullable — Color ID
  - `gearbox_id` integer, nullable — Gearbox type ID
  - `gearbox_shift_id` integer, nullable — Gearbox shift type ID
  - `origin_id` integer, nullable — Origin ID (national, imported)
  - `capacity_id` integer, nullable — Seating capacity ID
  - `doors_id` integer, nullable — Door count ID
  - `registration_id` integer, nullable — Registration type ID
  - `class_id` integer, nullable — Vehicle class ID
  - `condition_id` integer, nullable — Vehicle condition ID
  - `traction_id` integer, nullable — Traction type ID (FWD, RWD, AWD)
  - `version_id` integer, nullable — Specific version/trim ID
  - `registration` string, required — License plate / Registration number
  - `vin` string, nullable — Vehicle Identification Number
  - `version_designation` string, nullable — Version name/designation
  - `mileage` integer, required — Mileage in kilometers
  - `power` integer, required — Engine power in HP
  - `engine_capacity` integer, required — Engine capacity in cc
  - `first_registration_year` integer, required — Year of first registration
  - `first_registration_month` integer, required — Month of first registration (1-12)
  - `price` number, required — Sale price
  - `vendors_warranty_months` integer, nullable — Vendor warranty in months
  - `inspection_valid_until` string, nullable — Inspection valid until date (YYYY-MM-DD)
  - `maker_warranty_valid_until_date` string, nullable — Manufacturer warranty end date
  - `maker_warranty_valid_until_km` string, nullable — Manufacturer warranty km limit
  - `co2_emissions` string, nullable — CO2 emissions (g/km)
  - `iuc` string, nullable — Annual road tax (IUC)
  - `max_fuel_range` string, nullable — Maximum fuel range in km
  - `urban_consumption` string, nullable — Urban fuel consumption (L/100km)
  - `extra_urban_consumption` string, nullable — Extra-urban consumption
  - `combined_consumption` string, nullable — Combined fuel consumption
  - `max_speed` string, nullable — Maximum speed (km/h)
  - `metallic` union — Metallic paint (1 or '')
    - integer
    - string
  - `fixed_value` union — Fixed price / No negotiation (1 or '')
    - integer
    - string
  - `value_without_isv` union — Price without ISV tax (1 or '')
    - integer
    - string
  - `accept_returns` union — Accepts returns (1 or '')
    - integer
    - string
  - `accept_funding` union — Accepts financing (1 or '')
    - integer
    - string
  - `classic` union — Classic vehicle (1 or '')
    - integer
    - string
  - `damaged` union — Damaged vehicle (1 or '')
    - integer
    - string
  - `non_smoking` union — Non-smoking vehicle (1 or '')
    - integer
    - string
  - `particle_filter` union — Has particle filter (1 or '')
    - integer
    - string
  - `complete_review_book` union — Complete service book (1 or '')
    - integer
    - string
  - `salvage` union — Salvage vehicle (1 or '')
    - integer
    - string
  - `second_key` union — Has second key (1 or '')
    - integer
    - string
  - `features` integer[] — List of feature IDs
  - `location_id` string, required — Dealership location ID
  - `description` string, nullable — Vehicle description text
  - `video` string, nullable — Video URL

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/multigest/apis/multigest-protected-api.md) · [All operations](https://skmtc.dev/multigest/apis/multigest-protected-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/multigest/multigest-protected-api/revisions/4b44eb76b3ee/schema)