---
title: "Creates a new order or adds items to an existing order"
method: PUT
path: "/admin/orders"
tags: ["Admin"]
---

# Creates a new order or adds items to an existing order

`PUT /admin/orders`

## Request

- Base URL: `https://api.travelify.io`
- URL: `https://api.travelify.io/admin/orders`
- Auth: none declared

## Request body

- OrderDataDBO: Model for order database object
  - `id` integer: Order identifier
  - `key` string, nullable: Order key
  - `status` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8: Enumerator defining order status:<br>1=Basket, 2=Processing, 3=Confirmed, 4=ConfirmedFailure, 5=Cancelled, 6=CancelledPartial, 7=OnHold, 8=ConfirmedPayLater
  - `orderRef` string, nullable: Order reference to display to customer
  - `userID` string, nullable: IGNORE: Used for external data sources
  - `searchId` integer, nullable: Primary search identifier used to create order
  - `agentId` integer, nullable: Agent identifier
  - `customerId` integer, nullable: Customer identifier
  - `backofficeUrl` string, nullable: Backoffice order view url
  - `customBranding` OrderBrandingDBO: Model for defining custom order branding
    - `logoUrl` string, nullable: Branding logo url
    - `companyName` string, nullable: Branding company name
    - `emailAddress` string, nullable: Branding email address
    - `telephoneNumber` string, nullable: Branding telephone number
    - `address` string, nullable: Branding address
  - `customerTitle` 0 | 1 | 2 | 3 | 4 | 5 | 6: Enumerator defining traveller name titles:<br>0=Unspecified, 1=Mr, 2=Miss, 3=Mrs, 4=Ms, 5=Master, 6=Dr
  - `customerFirstname` string, nullable: Customer first name
  - `customerSurname` string, nullable: Customer surname
  - `customerEmail` string, nullable: Customer email address
  - `customerAddress1` string, nullable: Customer billing address 1
  - `customerAddress2` string, nullable: Customer billing address 2
  - `customerCity` string, nullable: Customer billing city
  - `customerState` string, nullable: Customer billing state/county
  - `customerPostalCode` string, nullable: Customer billing postal code
  - `customerCountryCode` string, nullable: Customer billing country code
  - `customerTelType` 1 | 2 | 3 | 4: Enumerator defining phone types:<br>1=Generic, 2=Mobile, 3=Home, 4=Office
  - `customerTelPrefix` string, nullable: Customer telephone prefix
  - `customerTelNum` string, nullable: Customer telephone number
  - `customerAcceptsMarketing` boolean, nullable: Customer accepts marketing
  - `specialRequests` string, nullable: Optional special requests
  - `language` string, nullable: Order language
  - `currency` string, nullable: Order currency code
  - `ipAddress` string, nullable: Customer IP address
  - `created` string, date-time: Order creation date time
  - `voucherId` integer, nullable: Voucher id
  - `voucherCode` string, nullable: Voucher code
  - `voucherName` string, nullable: Voucher name
  - `voucherValue` number, double, nullable: Voucher value
  - `voucherIsPercent` boolean, nullable: Voucher is a percentage discount
  - `voucherIsGift` boolean, nullable: Voucher is a gift voucher
  - `summary` string, nullable: Summary title of order used for front end display
  - `locationImageUrl` string, nullable: Location image url used for front end display
  - `locationGuide` string, nullable: Location guide used for front end display
  - `locationWeatherAvg` WeatherAverages: Model for weather averages for a location
    - `id` integer: Location identifier
    - `name` string, nullable: Location name
    - `latitude` number, double: Latitude
    - `longitude` number, double: Longitude
    - `distance` number, double, nullable: Distance
    - `units` 1 | 2 | 3: Enumerator defining unit of distance:<br>1=KM, 2=Miles, 3=NauticalMiles
    - `month` MonthData: Model for monthly weather averages
      - `month` integer: Month identifier
      - `monthName` string, nullable: Month name
      - `tempF` integer, nullable: Average temperature in F
      - `tempC` integer, nullable: Average temperature in C
      - `maxTempF` integer, nullable: Average max temperature in F
      - `maxTempC` integer, nullable: Average max temperature in C
      - `rainMM` number, double, nullable: Average daily rainfall in mm
      - `rainInch` number, double, nullable: Average daily rainfall in inches
      - `dryDays` integer, nullable: Average number of dry days
      - `rainDays` integer, nullable: Average number of rainy days
      - `snowDays` integer, nullable: Average number of snow days
      - `uvIndex` integer, nullable: Average UV index
      - `sunHours` number, double, nullable: Average sun hours
    - `months` MonthData[], nullable: Array of monthly averages (returned when all months requested or no travel date)
      - `month` integer: Month identifier
      - `monthName` string, nullable: Month name
      - `tempF` integer, nullable: Average temperature in F
      - `tempC` integer, nullable: Average temperature in C
      - `maxTempF` integer, nullable: Average max temperature in F
      - `maxTempC` integer, nullable: Average max temperature in C
      - `rainMM` number, double, nullable: Average daily rainfall in mm
      - `rainInch` number, double, nullable: Average daily rainfall in inches
      - `dryDays` integer, nullable: Average number of dry days
      - `rainDays` integer, nullable: Average number of rainy days
      - `snowDays` integer, nullable: Average number of snow days
      - `uvIndex` integer, nullable: Average UV index
      - `sunHours` number, double, nullable: Average sun hours
  - `departure` string, date-time, nullable: Departure date used for front end display
  - `duration` integer, nullable: Duration of travel used for front end display
  - `items` OrderItemDBO[], nullable: Array of order items
    - `id` integer: Item identifier
    - `orderId` integer, nullable: Order link id
    - `status` 1 | 2 | 3 | 4 | 5 | 6: Enumerator defining order item status:<br>1=Unconfirmed, 2=Processing, 3=OnHold, 4=Confirmed, 5=ConfirmedFailure, 6=Cancelled
    - `product` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20: Enumerator defining product types:<br>1=Flights, 2=Accommodation, 3=Packages, 4=TicketsAttractions, 5=Transfers, 6=AirportExtras, 7=Insurance, 8=CarRental, 9=Visas, 10=Tours, 11=Tracking, 12=Itinerary, 13=PaymentService, 14=CRM, 15=Extras, 16=DynamicPackage, 17=Rail, 18=Generic, 19=Cruise, 20=TicketPackage
    - `supplier` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 | 33 | 34 | 35 | 36 | 37 | 38 | 39 | 40 | 41 | 42 | 43 | 44 | 45 | 46 | 47 | 48 | 49 | 50 | 51 | 52 | 53 | 54 | 55 | 56 | 57 | 58 | 59 | 60 | 61 | 62 | 63 | 64 | 65 | 66 | 67 | 68 | 69 | 70 | 71 | 72 | 73 | 74 | 75 | 76 | 77 | 78 | 79 | 80 | 81 | 82 | 83 | 84 | 85 | 86 | 87 | 88 | 89 | 90 | 91 | 92 | 93 | 94 | 95 | 96 | 97 | 98 | 99 | 100 | 101 | 102 | 103 | 104 | 105 | 106 | 107 | 108 | 109 | 110 | 111 | 112 | 113 | 114 | 115 | 116 | 117 | 118 | 119 | 120 | 121 | 122 | 123 | 124 | 125 | 126 | 127 | 128 | 129 | 130 | 131 | 132 | 133 | 134 | 135 | 136 | 137 | 138 | 139 | 140 | 141 | 142 | 143 | 144 | 145 | 146 | 147 | 148 | 149 | 150 | 151 | 152 | 153 | 154 | 155 | 156 | 157 | 158 | 159 | 160 | 161 | 162 | 163 | 164 | 165 | 166 | 167 | 168 | 169 | 170 | 171 | 172 | 173 | 174 | 175 | 176 | 177 | 178 | 179 | 180 | 181 | 182 | 183 | 184 | 185 | 186 | 187 | 188 | 189 | 190 | 191: Enumerator defining supplier types:<br>0=Unknown, 1=HitchHiker, 2=GoldMedalDNATA, 3=HotelBeds, 4=Ingresso, 5=Hoppa, 6=HolidayExtras, 7=FlexibleAutos, 8=AvisBudget, 9=VisaHQ, 10=EAN, 11=Insightly, 12=Tiqets, 13=HolidayTaxis, 14=GAdventures, 15=GoogleAnalytics, 16=Homestay, 17=ApartmentsApart, 18=Mailchimp, 19=Interhome, 20=DemoFlights, 21=TravelifyComparison, 22=SygicData, 23=DemoCarRental, 24=DemoTickets, 25=Leezair, 26=Traveltek, 27=YpsilonFlights, 28=Paxport, 29=Stripe, 30=Braintree, 31=ArrivalGuides, 32=WalkScore, 33=Encharge, 34=MailerLite, 35=DemoTransfer, 36=DemoAirportExtras, 37=AttractionWorld, 38=Square, 39=Impala, 40=PayPal, 41=SolmarVillas, 42=GFAHub, 43=Hubspot, 44=Zapier, 45=RateHawk, 46=Musement, 47=Intuitive, 48=ManualPayments, 49=eMerchantPay, 50=Worldpay, 51=GoGlobal, 52=TBO, 53=Carnect, 54=Yalago, 55=TIG, 56=RadicalStorage, 57=Penguin, 58=BlueInsurance, 59=Opayo, 60=Dolphin, 61=Jet2, 62=Felloh, 63=Barclaycard, 64=GoogleSheets, 65=FlyNowPayLater, 66=Travelify, 67=Tarsc, 68=EcommPay, 69=TrustPayments, 70=GetResponse, 71=Cardstream, 72=TripSolutions, 73=Innstant, 74=Bookabed, 75=JumboTours, 76=DOTW, 77=SunHotels, 78=PTSCloud, 79=Teldar, 80=TripAdvisor, 81=RePUSHTI, 82=Albena, 83=JTA, 84=APH, 85=What3words, 86=Moretrees, 87=Ecologi, 88=OTS, 89=Duffel, 90=Smyrooms, 91=Shareasale, 92=Sendy, 93=Feefo, 94=ConstantContact, 95=Webhook, 96=RoadGoat, 97=Tripian, 98=Olympic, 99=Skistar, 100=iTravex, 101=Suntransfers, 102=Afterpay, 103=Dixa, 104=CCAvenue, 105=AIBMS, 106=Seon, 107=Clicky, 108=Telr, 109=Zoho, 110=Etihad, 111=Advantage, 112=GetAddress, 113=Brightsun, 114=Hotelplanner, 115=USAePay, 116=ReePay, 117=Mondee, 118=VisitGroup, 119=SKAPIT, 120=Faremine, 121=ITSGroup, 122=MyFatoorah, 123=EveryHoliday, 124=ChatGPT, 125=Rewardful, 126=FlutterWave, 127=Decta, 128=Liftie, 129=HighLevelCRM, 130=DidaTravel, 131=Altura, 132=RMI, 133=Tixstock, 134=HNHolidays, 135=CurrencyExchange, 136=Evolvi, 137=Darina, 138=Klaviyo, 139=AerTicket, 140=ProtectGroup, 141=GoogleLogin, 142=VivaPayments, 143=Widgety, 144=Xs2Event, 145=Whapi, 146=CurrencyConverterAPI, 147=Pax2Pay, 148=TravelvogueAnex, 149=SingleSignOn, 150=TTSS, 151=SerpApi, 152=GlobalPay, 153=PKFare, 154=PierreVacances, 155=MercuryHolidays, 156=SunshineTech, 157=TUI, 158=NowPayments, 159=Stuba, 160=Skiset, 161=Easemytrip, 162=LiftsTo, 163=Jonview, 164=SinGSTravel, 165=PayFast, 166=IVectorConnect, 167=ZestCarRental, 168=BarclaysFuse, 169=MajorTravel, 170=Travelpack, 171=MintPayments, 172=TravelWorks, 173=Atlas, 174=Custom, 175=IdealPostcodes, 176=Paximum, 177=Webhotelier, 178=TTNG, 179=SportsEvents365, 180=Brevo, 181=TGContracting, 182=Amitour, 183=TotalProcessing, 184=InComm, 185=Intercom, 186=Eurosite, 187=Revolut, 188=Karpaten, 189=Love2Shop, 190=LunaCRM, 191=UTalk
    - `searchId` integer, nullable: Search identifier
    - `searchKey` string, nullable: Search security key
    - `threadId` integer: Thread identifier
    - `depositOptionId` integer, nullable: Deposit option identifier
    - `reference` string, nullable: Unique supplier reference
    - `bookingReference` string, nullable: Supplier booking reference
    - `bookingError` string, nullable: Supplier booking error
    - `originalCurrency` string, nullable: Original currency
    - `originalPrice` number, double, nullable: Original price
    - `exchangeRate` number, double: Exchange rate
    - `price` number, double: Selling price
    - `pricePreMod` number, double, nullable: Selling price pre-modified
    - `payNowPrice` number, double, nullable: Pay now price
    - `payDeadline` string, date-time, nullable: Payment deadline
    - `startDate` string, date-time, nullable: Optional start date of item
    - `duration` integer, nullable: Optional duration of item
    - `data` string, nullable: Raw item data
    - `dataObject` unknown
    - `updated` string, date-time: Updated date time
    - `created` string, date-time: Creation date time
  - `payments` OrderPaymentDBO[], nullable: Array of order payments
    - `id` integer: Payment identifier
    - `orderId` integer, nullable: Order link id
    - `supplier` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 | 33 | 34 | 35 | 36 | 37 | 38 | 39 | 40 | 41 | 42 | 43 | 44 | 45 | 46 | 47 | 48 | 49 | 50 | 51 | 52 | 53 | 54 | 55 | 56 | 57 | 58 | 59 | 60 | 61 | 62 | 63 | 64 | 65 | 66 | 67 | 68 | 69 | 70 | 71 | 72 | 73 | 74 | 75 | 76 | 77 | 78 | 79 | 80 | 81 | 82 | 83 | 84 | 85 | 86 | 87 | 88 | 89 | 90 | 91 | 92 | 93 | 94 | 95 | 96 | 97 | 98 | 99 | 100 | 101 | 102 | 103 | 104 | 105 | 106 | 107 | 108 | 109 | 110 | 111 | 112 | 113 | 114 | 115 | 116 | 117 | 118 | 119 | 120 | 121 | 122 | 123 | 124 | 125 | 126 | 127 | 128 | 129 | 130 | 131 | 132 | 133 | 134 | 135 | 136 | 137 | 138 | 139 | 140 | 141 | 142 | 143 | 144 | 145 | 146 | 147 | 148 | 149 | 150 | 151 | 152 | 153 | 154 | 155 | 156 | 157 | 158 | 159 | 160 | 161 | 162 | 163 | 164 | 165 | 166 | 167 | 168 | 169 | 170 | 171 | 172 | 173 | 174 | 175 | 176 | 177 | 178 | 179 | 180 | 181 | 182 | 183 | 184 | 185 | 186 | 187 | 188 | 189 | 190 | 191: Enumerator defining supplier types:<br>0=Unknown, 1=HitchHiker, 2=GoldMedalDNATA, 3=HotelBeds, 4=Ingresso, 5=Hoppa, 6=HolidayExtras, 7=FlexibleAutos, 8=AvisBudget, 9=VisaHQ, 10=EAN, 11=Insightly, 12=Tiqets, 13=HolidayTaxis, 14=GAdventures, 15=GoogleAnalytics, 16=Homestay, 17=ApartmentsApart, 18=Mailchimp, 19=Interhome, 20=DemoFlights, 21=TravelifyComparison, 22=SygicData, 23=DemoCarRental, 24=DemoTickets, 25=Leezair, 26=Traveltek, 27=YpsilonFlights, 28=Paxport, 29=Stripe, 30=Braintree, 31=ArrivalGuides, 32=WalkScore, 33=Encharge, 34=MailerLite, 35=DemoTransfer, 36=DemoAirportExtras, 37=AttractionWorld, 38=Square, 39=Impala, 40=PayPal, 41=SolmarVillas, 42=GFAHub, 43=Hubspot, 44=Zapier, 45=RateHawk, 46=Musement, 47=Intuitive, 48=ManualPayments, 49=eMerchantPay, 50=Worldpay, 51=GoGlobal, 52=TBO, 53=Carnect, 54=Yalago, 55=TIG, 56=RadicalStorage, 57=Penguin, 58=BlueInsurance, 59=Opayo, 60=Dolphin, 61=Jet2, 62=Felloh, 63=Barclaycard, 64=GoogleSheets, 65=FlyNowPayLater, 66=Travelify, 67=Tarsc, 68=EcommPay, 69=TrustPayments, 70=GetResponse, 71=Cardstream, 72=TripSolutions, 73=Innstant, 74=Bookabed, 75=JumboTours, 76=DOTW, 77=SunHotels, 78=PTSCloud, 79=Teldar, 80=TripAdvisor, 81=RePUSHTI, 82=Albena, 83=JTA, 84=APH, 85=What3words, 86=Moretrees, 87=Ecologi, 88=OTS, 89=Duffel, 90=Smyrooms, 91=Shareasale, 92=Sendy, 93=Feefo, 94=ConstantContact, 95=Webhook, 96=RoadGoat, 97=Tripian, 98=Olympic, 99=Skistar, 100=iTravex, 101=Suntransfers, 102=Afterpay, 103=Dixa, 104=CCAvenue, 105=AIBMS, 106=Seon, 107=Clicky, 108=Telr, 109=Zoho, 110=Etihad, 111=Advantage, 112=GetAddress, 113=Brightsun, 114=Hotelplanner, 115=USAePay, 116=ReePay, 117=Mondee, 118=VisitGroup, 119=SKAPIT, 120=Faremine, 121=ITSGroup, 122=MyFatoorah, 123=EveryHoliday, 124=ChatGPT, 125=Rewardful, 126=FlutterWave, 127=Decta, 128=Liftie, 129=HighLevelCRM, 130=DidaTravel, 131=Altura, 132=RMI, 133=Tixstock, 134=HNHolidays, 135=CurrencyExchange, 136=Evolvi, 137=Darina, 138=Klaviyo, 139=AerTicket, 140=ProtectGroup, 141=GoogleLogin, 142=VivaPayments, 143=Widgety, 144=Xs2Event, 145=Whapi, 146=CurrencyConverterAPI, 147=Pax2Pay, 148=TravelvogueAnex, 149=SingleSignOn, 150=TTSS, 151=SerpApi, 152=GlobalPay, 153=PKFare, 154=PierreVacances, 155=MercuryHolidays, 156=SunshineTech, 157=TUI, 158=NowPayments, 159=Stuba, 160=Skiset, 161=Easemytrip, 162=LiftsTo, 163=Jonview, 164=SinGSTravel, 165=PayFast, 166=IVectorConnect, 167=ZestCarRental, 168=BarclaysFuse, 169=MajorTravel, 170=Travelpack, 171=MintPayments, 172=TravelWorks, 173=Atlas, 174=Custom, 175=IdealPostcodes, 176=Paximum, 177=Webhotelier, 178=TTNG, 179=SportsEvents365, 180=Brevo, 181=TGContracting, 182=Amitour, 183=TotalProcessing, 184=InComm, 185=Intercom, 186=Eurosite, 187=Revolut, 188=Karpaten, 189=Love2Shop, 190=LunaCRM, 191=UTalk
    - `paymentType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25: Enumerator defining payment types card,ideal,alipay,bancontact,eps,giropay,multibanco,sepa_debit,p24,sofort,wechat:<br>0=None, 1=Card, 2=iDEAL, 3=Alipay, 4=Bancontact, 5=EPS, 6=Giropay, 7=Multibanco, 8=SepaDebit, 9=Przelewy24, 10=Sofort, 11=WeChat, 12=GooglePay, 13=ApplePay, 14=DirectDebit, 15=PayPal, 16=BankTransfer, 17=Cash, 18=Account, 19=CreditLimit, 20=Link, 21=Klarna, 22=ClearpayAfterpay, 23=Crypto, 24=PayLater, 25=GiftCard
    - `status` 1 | 2 | 3 | 4: Enumerator defining payment status:<br>1=Success, 2=Pending, 3=Failed, 4=Refunded
    - `reference` string, nullable: Payment reference
    - `summary` string, nullable: Payment summary (e.g. Payment by Visa card ending ***4143)
    - `amount` number, double: Amount of payment
    - `currency` string, nullable: Payment currency (should match order currency)
    - `created` string, date-time: Payment created or processed
  - `depositOption` OrderDepositOptionDBO: Model for defining deposit option
    - `id` integer: Deposit identifier
    - `optionId` integer: Deposit option identifier
    - `initialAmount` number, double: Initial payment amount
    - `currency` string, nullable: Currency code
    - `breakdown` DepositBreakdown[], nullable: Breakdown
      - `num` integer: Installment number
      - `amount` number, double: Installment amount
      - `dueDate` string, date-time: Installment due date
      - `supplierDueDate` string, date-time, nullable: Optional supplier balance due date
  - `documents` OrderDocumentDBO[], nullable: Array of order documents
    - `id` integer: Document identifier
    - `key` string, nullable: Document security key
    - `type` 1 | 2: Enumerator defining order document types:<br>1=Shared, 2=OrderSpecific
    - `name` string, nullable: Document name
    - `ext` string, nullable: Document file extension (e.g. pdf, docx, etc.)
    - `size` integer, nullable: Document size (bytes)
    - `url` string, nullable: URL to access document
    - `created` string, date-time: Created date time
  - `vouchers` OrderVoucherDBO[], nullable: Array of vouchers against order (advanced use only)
    - `id` integer, nullable: Voucher id
    - `code` string, nullable: Voucher code
    - `name` string, nullable: Voucher name
    - `value` number, double: Voucher value
    - `isPercent` boolean, nullable: Voucher is a percentage discount
    - `isGift` boolean, nullable: Voucher is a gift voucher
  - `data` object, nullable: Order data
  - `sources` object, nullable: Order tracking sources
  - `upsellsActive` ProductTypes[], nullable: List of upsell products active on application

## Response `200`

OK

## Other responses

- `400`: Bad Request
- `401`: Unauthorized

## Changes

- **2026-10-22** `28d37ad33b44`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/travelify/apis/travelify-io-api/changes/admin/orders/put.md)

---

[API](https://skmtc.dev/travelify/apis/travelify-io-api.md) - [All operations](https://skmtc.dev/travelify/apis/travelify-io-api/llms.txt) - [OpenAPI document](https://skmtc.dev/travelify/apis/travelify-io-api/revisions/70f1c708e1af?raw)