> ## Documentation Index > Fetch the complete documentation index at: https://docs.drivly.dev/llms.txt > Use this file to discover all available pages before exploring further. # Create a new Service Order > Create a new Service Order Make sure you install our SDK first. You can find out how, and more [here](/commerce/sdk). ```typescript theme={null} import { SDK } from '@drivly/commerce' import type { serviceOrders } from '@drivly/commerce' const sdk = new SDK(...) const serviceOrders = await sdk.serviceOrders.create(data: serviceOrders): Promise ``` ## OpenAPI ````yaml post /serviceOrders openapi: 3.0.3 info: title: Drivly Commerce API version: 1.0.0 description: API for the Driv.ly experience contact: name: Drivly url: https://driv.ly email: support@driv.ly license: name: MIT url: https://opensource.org/licenses/MIT servers: - url: https://commerce.driv.ly/api security: [] paths: /serviceOrders: post: tags: - serviceOrders summary: Create a new Service Order description: Create a new Service Order parameters: - name: depth in: query description: number of levels to automatically populate relationships and uploads schema: type: number - name: locale in: query description: retrieves document(s) in a specific locale schema: type: string - name: fallback-locale in: query description: specifies a fallback locale if no locale value exists schema: type: string requestBody: $ref: '#/components/requestBodies/serviceOrdersRequest' responses: '200': $ref: '#/components/responses/serviceOrdersUpsertConfirmationResponse' security: - apiKeyAuth: [] components: requestBodies: serviceOrdersRequest: content: application/json: schema: $ref: '#/components/schemas/serviceOrders' responses: serviceOrdersUpsertConfirmationResponse: description: ok content: application/json: schema: $ref: '#/components/schemas/serviceOrdersUpsertConfirmation' schemas: serviceOrders: additionalProperties: false title: ServiceOrder type: object properties: name: type: string nullable: true type: items: enum: - Condition Inspection - Last Mile Delivery - Long Haul Transport - Mechanical Inspection - Post Sale Inspection - Pre-Paid Maintenance - Pre-Purchase Inspection - Safety Inspection - Vehicle Service Contract - Wash And Detail type: string type: array nullable: true customer: items: oneOf: - type: number - additionalProperties: false title: Customer type: object properties: customerId: type: string nullable: true leads: items: type: number type: array nullable: true address: type: number nullable: true shippingContact: type: number nullable: true deals: items: type: number type: array nullable: true createdBy: type: number nullable: true lastModifiedBy: type: number nullable: true email: type: string nullable: true phone: type: string nullable: true insurancePolicies: items: type: number type: array nullable: true tenants: items: type: number type: array nullable: true consumerStatus: enum: - SOLD - Pending - Working - Cold - LOST - Duplicate - DNC type: string nullable: true consumerFirstName: type: string nullable: true consumerMiddleName: type: string nullable: true consumerLastName: type: string nullable: true consumerSuffix: type: string nullable: true consumerDateOfBirth: type: string nullable: true consumerEducationLevel: type: string nullable: true consumerVehicles: items: type: number type: array nullable: true consumerPhoneType: type: string nullable: true consumerDriversLicense: type: string nullable: true consumerDriversLicenseState: type: string nullable: true consumerDriversLicenseNumber: type: string nullable: true consumerDriversLicenseExp: type: string nullable: true consumerDriversLicenseExpiration: type: string nullable: true consumerPreApprovals: items: type: number type: array nullable: true consumerGetPreApproved: type: string nullable: true consumerProvideProofOfInsurance: type: string nullable: true consumerLoginToBank: type: string nullable: true consumerConnectCar: type: string nullable: true consumerProvideProofOfIncome: type: string nullable: true consumerConsumerId: type: string nullable: true consumerCreditApplicationId: type: string nullable: true deals2: items: type: number type: array nullable: true consumerSocialSecurity: type: string nullable: true consumerDriversLicenceState: type: string nullable: true consumerIncome: type: number nullable: true consumerIncomeInterval: type: string nullable: true consumerEmploymentStatusCode: type: string nullable: true consumerEmploymentDuration: type: number nullable: true consumerEmployerName: type: string nullable: true consumerEmployerPhone: type: string nullable: true consumerEmploymentTitle: type: string nullable: true consumerPreviousEmployerName: type: string nullable: true consumerPreviousEmployerPhone: type: string nullable: true consumerPreviousEmploymentTitle: type: string nullable: true consumerPreviousEmploymentDuration: type: number nullable: true consumerPreviousEmploymentincome: type: number nullable: true consumerTimeAtResidence: type: number nullable: true consumerPreviousAddressLine1: type: string nullable: true consumerPreviousAddressLine2: type: string nullable: true consumerPreviousAddressCity: type: string nullable: true consumerPreviousAddressState: type: string nullable: true consumerPreviousZip: type: string nullable: true consumerPreviousAddressDuration: type: number nullable: true consumerResidenceType: type: string nullable: true consumerRentMortgage: type: number nullable: true consumerOtherIncomeDescription: type: string nullable: true consumerOtherIncomeAmount: type: number nullable: true consumerLeadSource: items: enum: - Car Concierge (Andrew) - Driv.ly Website - Self Generated - Referral - Rocket type: string type: array nullable: true companyName: type: string nullable: true companyDealerDeals: items: type: number type: array nullable: true companyDealsFacilitated: items: type: number type: array nullable: true companyInsuranceQuotes: items: type: number type: array nullable: true companyType: items: enum: - Dealer - Concierge - Broker - Partner - Auction - Affiliate - Insurer - Mobile Detailer - Last Mile Transporter - Service Provider - Lender type: string type: array nullable: true companyWebsite: type: string nullable: true companyStripeConnectLink: type: string nullable: true companyCustomerPortalLink: type: string nullable: true companyServiceQuotes: items: type: number type: array nullable: true companyServiceOrders: type: string nullable: true companyServiceQuotesPartners: items: type: number type: array nullable: true companyVisibility: type: string nullable: true companyTenants2: items: type: number type: array nullable: true companyCustomer: items: type: number type: array nullable: true companyTrades: items: type: number type: array nullable: true companyTenants3: items: type: number type: array nullable: true companyPartnerBrand: type: number nullable: true companyDeals3: items: type: number type: array nullable: true companyRouteOneDealer: type: string nullable: true companyTransportServiceOrders: items: type: number type: array nullable: true updatedAt: type: string createdAt: type: string required: - id - updatedAt - createdAt type: array nullable: true serviceQuotes: oneOf: - type: number nullable: true - additionalProperties: false title: ServiceQuote type: object properties: name: type: string nullable: true type: items: enum: - Vehicle Service Contract - Pre-Paid Maintenance - Long Haul Transport - Last Mile Delivery - Pre-Purchase Inspection - Post Sale Inspection - Condition Inspection - Safety Inspection - Mechanical Inspection - Wash And Detail type: string type: array nullable: true status: enum: - Quoted - Pending - In Review - Active - Dispatched - En Route - Complete - Hold - Cancel - Error type: string nullable: true serviceProvider: items: type: number type: array nullable: true quoteId: type: string nullable: true partner: type: number nullable: true serviceOrders: type: string nullable: true checkoutLink: type: string nullable: true deal: type: number nullable: true vehicle: type: number nullable: true rush: type: boolean nullable: true etaMin: type: string nullable: true etaMax: type: string nullable: true distance: type: number nullable: true expires: type: string nullable: true cost: type: string nullable: true price: type: string nullable: true margin: type: string nullable: true partnerProfitShare: type: string nullable: true partnerMargin: type: string nullable: true tenant: type: number nullable: true transportServiceOrders: type: string nullable: true transportServiceOrders2: items: type: number type: array nullable: true updatedAt: type: string createdAt: type: string required: - id - updatedAt - createdAt paymentLink: type: string nullable: true vin: oneOf: - type: number nullable: true - additionalProperties: false title: Vehicle type: object properties: name: type: string nullable: true vin: type: string nullable: true customer: type: number nullable: true status: items: enum: - Bought at Auction - Inspected - Transport to Inspection - Transport to Customer - Arbitration - Bid Placed - SOLD TO CUSTOMER - Identified as potential option for customer - Taken in on Trade - Trade sold at Auction - Trade sold Retail type: string type: array nullable: true deals: items: type: number type: array nullable: true year: type: string nullable: true make: type: string nullable: true model: type: string nullable: true trim: type: string nullable: true style: type: string nullable: true body: type: string nullable: true drivetrain: type: string nullable: true engine: type: string nullable: true transmission: type: string nullable: true interior: type: string nullable: true exterior: type: string nullable: true listings: items: type: number type: array nullable: true serviceQuotes: items: type: number type: array nullable: true tenant: type: number nullable: true trades: items: type: number type: array nullable: true createdBy: type: number nullable: true transportServiceOrders: type: string nullable: true transportServiceOrders2: items: type: number type: array nullable: true updatedAt: type: string createdAt: type: string required: - id - updatedAt - createdAt status: enum: - Quoted - Pending - In Review - Active - Dispatched - En Route - Complete - Hold - Cancel - Error type: string nullable: true error: type: string nullable: true orderId: type: string nullable: true price: type: string nullable: true rush: type: boolean nullable: true attachments: items: oneOf: - type: number - additionalProperties: false title: Attachment type: object properties: name: type: string nullable: true status: enum: - Error - Sending - Sent type: string nullable: true type: type: string nullable: true file: type: string nullable: true serviceOrders: type: string nullable: true orderId: type: string nullable: true transportServiceOrders: items: type: number type: array nullable: true updatedAt: type: string createdAt: type: string required: - id - updatedAt - createdAt type: array nullable: true quoteExpiration: type: string nullable: true ordered: type: string nullable: true start: type: string nullable: true due: type: string nullable: true consignor: oneOf: - type: number nullable: true - additionalProperties: false title: Contact type: object properties: name: type: string nullable: true status: enum: - Pending - Active - Inactive type: string nullable: true type: items: enum: - Auction - Mechanic - Operations - Back Office - Transporter - Detailer - Customer - Dealer type: string type: array nullable: true customer: type: number nullable: true addresses: type: number nullable: true transportServiceOrders: items: type: number type: array nullable: true transportServiceOrders2: items: type: number type: array nullable: true transportServiceOrders3: items: type: number type: array nullable: true transportServiceOrders4: items: type: number type: array nullable: true updatedAt: type: string createdAt: type: string required: - id - updatedAt - createdAt billTo: oneOf: - type: number nullable: true - additionalProperties: false title: Contact type: object properties: name: type: string nullable: true status: enum: - Pending - Active - Inactive type: string nullable: true type: items: enum: - Auction - Mechanic - Operations - Back Office - Transporter - Detailer - Customer - Dealer type: string type: array nullable: true customer: type: number nullable: true addresses: type: number nullable: true transportServiceOrders: items: type: number type: array nullable: true transportServiceOrders2: items: type: number type: array nullable: true transportServiceOrders3: items: type: number type: array nullable: true transportServiceOrders4: items: type: number type: array nullable: true updatedAt: type: string createdAt: type: string required: - id - updatedAt - createdAt origin: oneOf: - type: number nullable: true - additionalProperties: false title: Contact type: object properties: name: type: string nullable: true status: enum: - Pending - Active - Inactive type: string nullable: true type: items: enum: - Auction - Mechanic - Operations - Back Office - Transporter - Detailer - Customer - Dealer type: string type: array nullable: true customer: type: number nullable: true addresses: type: number nullable: true transportServiceOrders: items: type: number type: array nullable: true transportServiceOrders2: items: type: number type: array nullable: true transportServiceOrders3: items: type: number type: array nullable: true transportServiceOrders4: items: type: number type: array nullable: true updatedAt: type: string createdAt: type: string required: - id - updatedAt - createdAt destination: oneOf: - type: number nullable: true - additionalProperties: false title: Contact type: object properties: name: type: string nullable: true status: enum: - Pending - Active - Inactive type: string nullable: true type: items: enum: - Auction - Mechanic - Operations - Back Office - Transporter - Detailer - Customer - Dealer type: string type: array nullable: true customer: type: number nullable: true addresses: type: number nullable: true transportServiceOrders: items: type: number type: array nullable: true transportServiceOrders2: items: type: number type: array nullable: true transportServiceOrders3: items: type: number type: array nullable: true transportServiceOrders4: items: type: number type: array nullable: true updatedAt: type: string createdAt: type: string required: - id - updatedAt - createdAt deals: items: oneOf: - type: number - additionalProperties: false title: Deal type: object properties: customer: type: number nullable: true vehicle: type: number nullable: true dealId: type: string nullable: true customerRelationship: type: string nullable: true coCustomer: type: number nullable: true companyConsumerCustomer: type: number nullable: true lienHolder: items: type: number type: array nullable: true dealer: type: number nullable: true facilitator: items: type: number type: array nullable: true type: items: enum: - Wholesale Dropship - Wholesale - Concierge Search - Consignment - Instant Cash Offer - Concierge Buy - Private Party type: string type: array nullable: true salesPrice: type: string nullable: true margin: type: string nullable: true downPayment: type: string nullable: true financedAmount: type: string nullable: true taxesAndFees: type: number nullable: true dependencies: items: type: number type: array nullable: true unsignedDocuments: type: string nullable: true signedDocuments: type: string nullable: true deliveryAddress: items: type: number type: array nullable: true paymentLink: type: string nullable: true getTradeOffer: type: string nullable: true notarizePowerOfAttorney: type: string nullable: true serviceQuotes: items: type: number type: array nullable: true tenant: type: number nullable: true trades: items: type: number type: array nullable: true creditApplications: items: type: number type: array nullable: true latestError: type: string nullable: true vscProvider: type: number nullable: true vsc: type: string nullable: true gapProvider: type: number nullable: true gap: type: string nullable: true status: type: string nullable: true transportServiceOrders: items: type: number type: array nullable: true mileage: type: number nullable: true createdBy: type: number nullable: true lastModifiedBy: type: number nullable: true development: type: boolean nullable: true updatedAt: type: string createdAt: type: string required: - id - updatedAt - createdAt type: array nullable: true orderLink: type: string nullable: true tenant: items: oneOf: - type: number - additionalProperties: false title: Tenant type: object properties: name: type: string nullable: true customer: items: type: number type: array nullable: true defaultDealer: items: type: number type: array nullable: true defaultFacilitator: type: number nullable: true email: type: string nullable: true apiKey: type: string nullable: true environment: type: string nullable: true creditApplicationLabel: type: string nullable: true deals: items: type: number type: array nullable: true locations: items: type: number type: array nullable: true insuranceQuotes: items: type: number type: array nullable: true serviceQuotes: items: type: number type: array nullable: true serviceOrders: type: string nullable: true insurancePolicies: items: type: number type: array nullable: true addresses: items: type: number type: array nullable: true listings: items: type: number type: array nullable: true vehicles: items: type: number type: array nullable: true webhooks: items: type: number type: array nullable: true taxesAndFees: items: type: number type: array nullable: true dmvFees: items: type: number type: array nullable: true transportServiceOrders: items: type: number type: array nullable: true updatedAt: type: string createdAt: type: string required: - id - updatedAt - createdAt type: array nullable: true updatedAt: type: string createdAt: type: string required: - id - updatedAt - createdAt serviceOrdersUpsertConfirmation: type: object title: Service Order upsert confirmation properties: doc: additionalProperties: false title: ServiceOrder type: object properties: name: type: string nullable: true type: items: enum: - Condition Inspection - Last Mile Delivery - Long Haul Transport - Mechanical Inspection - Post Sale Inspection - Pre-Paid Maintenance - Pre-Purchase Inspection - Safety Inspection - Vehicle Service Contract - Wash And Detail type: string type: array nullable: true customer: items: type: number type: array nullable: true serviceQuotes: type: number nullable: true paymentLink: type: string nullable: true vin: type: number nullable: true status: enum: - Quoted - Pending - In Review - Active - Dispatched - En Route - Complete - Hold - Cancel - Error type: string nullable: true error: type: string nullable: true orderId: type: string nullable: true price: type: string nullable: true rush: type: boolean nullable: true attachments: items: type: number type: array nullable: true quoteExpiration: type: string nullable: true ordered: type: string nullable: true start: type: string nullable: true due: type: string nullable: true consignor: type: number nullable: true billTo: type: number nullable: true origin: type: number nullable: true destination: type: number nullable: true deals: items: type: number type: array nullable: true orderLink: type: string nullable: true tenant: items: type: number type: array nullable: true updatedAt: type: string createdAt: type: string required: - id - updatedAt - createdAt message: type: string required: - doc - message securitySchemes: apiKeyAuth: in: header type: apiKey name: Authorization ````