---
title: "Create"
method: POST
path: "/shipping/cargo_on_flight_house_air_waybills/create/v1"
tags: ["/shipping/cargo_on_flight_house_air_waybills"]
---

# Create

`POST /shipping/cargo_on_flight_house_air_waybills/create/v1`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/shipping/cargo_on_flight_house_air_waybills/create/v1`
- Auth: HTTP bearer

Adds a house air waybill to an air waybill's consolidation, sent to the airline in its FHL. | authz_personas=[task_group_coordinator_operators] | (CargoOnFlightHouseAirWaybillClientCreate1) -> (CargoOnFlightHouseAirWaybill1)

## Request body

- CargoOnFlightHouseAirWaybillClientCreate1
  - `schema_version` 1, required
  - `cargo_on_flight_air_waybill_id` string, required
  - `house_air_waybill_number` string, required
  - `number_of_pieces` integer, required
  - `gross_weight_kilograms` number, required
  - `slac` integer, nullable
  - `origin_iata` string, required
  - `destination_iata` string, required
  - `manifest_description_of_goods` string, required
  - `charges_declaration` CargoOnFlightAirWaybillChargesDeclaration1: Currency, payment, and declared values, for the master or a house air waybill.
    - `currency_code` string, required
    - `charge_code` 'CA' | 'CB' | 'CC' | 'CE' | 'CG' | 'CH' | 'CM' | 'CP' | 'CX' | 'CZ' | 'NC' | 'NG' | 'NP' | 'NT' | 'NX' | 'NZ' | 'PC' | 'PD' | 'PE' | 'PF' | 'PG' | 'PH' | 'PP' | 'PX' | 'PZ', required: IATA Cargo-IMP method of payment codes, e.g. PP all charges prepaid, CC all charges collect.
    - `payment_weight_valuation` 'prepaid' | 'collect'
    - `payment_other_charges` 'prepaid' | 'collect'
    - `declared_value_for_carriage` number, nullable
    - `declared_value_for_customs` number, nullable
    - `declared_value_for_insurance` number, nullable

## Response `200`

Successful Response

- CargoOnFlightHouseAirWaybill1
  - `schema_version` 1, required
  - `_id` string, required
  - `cargo_on_flight_air_waybill_id` string, required
  - `cargo_on_flight_booking_id` string, required
  - `task_group_id` string, required
  - `created_by_org_id` string, required: Must be a string starting with `org_`
  - `created_by_user_id` string, nullable: Must be a string starting with `user_`
  - `house_air_waybill_number` string, required
  - `number_of_pieces` integer, required
  - `gross_weight_kilograms` number, required
  - `slac` integer, nullable
  - `origin_iata` string, required
  - `destination_iata` string, required
  - `manifest_description_of_goods` string, required
  - `charges_declaration` CargoOnFlightAirWaybillChargesDeclaration1: Currency, payment, and declared values, for the master or a house air waybill.
    - `currency_code` string, required
    - `charge_code` 'CA' | 'CB' | 'CC' | 'CE' | 'CG' | 'CH' | 'CM' | 'CP' | 'CX' | 'CZ' | 'NC' | 'NG' | 'NP' | 'NT' | 'NX' | 'NZ' | 'PC' | 'PD' | 'PE' | 'PF' | 'PG' | 'PH' | 'PP' | 'PX' | 'PZ', required: IATA Cargo-IMP method of payment codes, e.g. PP all charges prepaid, CC all charges collect.
    - `payment_weight_valuation` 'prepaid' | 'collect'
    - `payment_other_charges` 'prepaid' | 'collect'
    - `declared_value_for_carriage` number, nullable
    - `declared_value_for_customs` number, nullable
    - `declared_value_for_insurance` number, nullable
  - `latest_fhl_message` CargoOnFlightHouseAirWaybillFhlMessage1: The latest send of the house in an FHL, and the airline's answer to it.
    - `cargo_on_flight_integration` 'air_canada' | 'cargoai' | 'manual', required
    - `status` 'sent' | 'accepted' | 'rejected', required
    - `sent_at_timestamp` string, date-time, required
    - `responded_at_timestamp` string, date-time, nullable
    - `response_provenance` 'airline' | 'manual'
    - `responded_by_user_id` string, nullable: Must be a string starting with `user_`
    - `airline_response` string, nullable
  - `created_at_timestamp` string, date-time, required
  - `updated_at_timestamp` string, date-time, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-13** `2aa61055d20a`: 1 warning
  - added the new `air_canada` enum value to the `latest_fhl_message/anyOf[subschema #1: CargoOnFlightHouseAirWaybillFhlMessage1]/cargo_on_flight_integration` response property for the response status `200`
- **2026-10-06** `cedb208482ba`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/chrt/apis/chrt-fastapi/changes/shipping/cargo_on_flight_house_air_waybills/create/v1/post.md)

---

[API](https://skmtc.dev/chrt/apis/chrt-fastapi.md) - [All operations](https://skmtc.dev/chrt/apis/chrt-fastapi/llms.txt) - [OpenAPI document](https://skmtc.dev/chrt/apis/chrt-fastapi/revisions/6f428e2e2b98?raw)