> ## Documentation Index > Fetch the complete documentation index at: https://docs.upwell.com/llms.txt > Use this file to discover all available pages before exploring further. # Create Many Carrier Invoices > Create multiple carrier invoices at once ## OpenAPI ````yaml /api-reference/openapi.json post /api/rest/bulk-carrier-invoices openapi: 3.1.0 info: description: >- Upwell is Accounts Receivable automation software for the logistics industry. We serve freight brokers, carriers, factors, and anyone who needs to get transportation invoices paid. Learn more at: - [Upwell.com](https://upwell.com) title: Upwell REST API version: 3.30.2 termsOfService: https://upwell.com/legal contact: name: Upwell url: https://upwell.com email: contact@upwell.com servers: - url: https://api.upwell.com description: Production server - url: https://staging.api.upwell.com description: Staging server security: [] tags: - name: Invoice Approval description: Endpoints for managing customer invoice approval workflow paths: /api/rest/bulk-carrier-invoices: post: tags: - Carrier Invoices summary: Create Many Carrier Invoices description: Create multiple carrier invoices at once parameters: - description: >- Your API key will be used for authentication of the request. `Authorization: YOUR_API_KEY` in: header name: authorization schema: type: string requestBody: content: application/json: schema: properties: inputs: items: $ref: '#/components/schemas/CarrierInvoicesInsertInput' nullable: false type: array type: object description: >- Query parameters can also be provided in the request body as a JSON object required: true responses: '200': content: application/json: schema: properties: createCarrierInvoices: description: response of any mutation on the table "carrier_invoices" nullable: true properties: returning: items: description: >- Invoices (payables) received from carriers (e.g. via email) nullable: false properties: balance: nullable: false title: Int type: integer billId: nullable: true title: String type: string carrierId: nullable: true title: String type: string carrierInvoiceLineItems: items: description: >- columns and relationships of "carrier_invoice_line_items" nullable: false properties: description: nullable: true title: String type: string id: nullable: false title: String type: string item: nullable: true title: String type: string lineNumber: nullable: true title: String type: string quantity: $ref: '#/components/schemas/numeric' totalAmount: nullable: true title: Int type: integer unitPrice: nullable: true title: Int type: integer title: CarrierInvoiceLineItems type: object nullable: false type: array createdAt: $ref: '#/components/schemas/timestamptz' currency: $ref: '#/components/schemas/CurrencyCodeEnum' dueDate: $ref: '#/components/schemas/date' exceptions: nullable: true title: String type: string id: nullable: false title: String type: string invoiceNumber: nullable: true title: String type: string issueDate: $ref: '#/components/schemas/date' loadNumber: nullable: true title: String type: string metadata: $ref: '#/components/schemas/jsonb' receivedAt: $ref: '#/components/schemas/timestamptz' referenceNumbers: $ref: '#/components/schemas/jsonb' shipmentId: nullable: true title: String type: string status: $ref: '#/components/schemas/CarrierInvoiceStatusEnum' totalAmount: nullable: true title: Int type: integer totalTaxAmount: nullable: true title: Int type: integer updatedAt: $ref: '#/components/schemas/timestamptz' title: CarrierInvoices type: object nullable: false type: array title: CarrierInvoicesMutationResponse type: object description: Responses for POST /api/rest/bulk-carrier-invoices components: schemas: CarrierInvoicesInsertInput: description: input type for inserting data into table "carrier_invoices" nullable: false properties: additionalReferenceNumbers: $ref: '#/components/schemas/jsonb' approvalRequests: type: object description: CarrierInvoiceApprovalRequestArrRelInsertInput (simplified) approvedAt: $ref: '#/components/schemas/timestamptz' assignedAt: $ref: '#/components/schemas/timestamptz' assignedBy: type: object description: UsersObjRelInsertInput (simplified) assignedById: $ref: '#/components/schemas/uuid' assignedTo: type: object description: UsersObjRelInsertInput (simplified) assignedToId: $ref: '#/components/schemas/uuid' balance: nullable: true title: Int type: integer description: >- The balance of the invoice. This should be in cents. For example, $100.00 should be represented as 10000. billId: nullable: true title: String type: string billOfLadingNumber: nullable: true title: String type: string carrierBillingAddress: type: object description: AddressesObjRelInsertInput (simplified) carrierBillingAddressId: nullable: true title: String type: string carrierDocumentRequests: type: object description: CarrierDocumentRequestsArrRelInsertInput (simplified) carrierId: nullable: true title: String type: string carrierName: nullable: true title: String type: string carrierProNumber: nullable: true title: String type: string createdAt: $ref: '#/components/schemas/timestamptz' createdFromEmailMessageId: nullable: true title: String type: string currency: $ref: '#/components/schemas/CurrencyCodeEnum' customerInvoiceId: nullable: true title: String type: string customerPoNumber: nullable: true title: String type: string customerReferenceNumber: nullable: true title: String type: string documentsModifiedAt: $ref: '#/components/schemas/timestamp' documentsTypeOrCustomerVisibilityUpdatedAt: $ref: '#/components/schemas/timestamp' dueDate: $ref: '#/components/schemas/date' emailMessageAssociations: type: object description: EmailMessageAssociationsArrRelInsertInput (simplified) factor: type: object description: FactorsObjRelInsertInput (simplified) factorAddress: type: object description: AddressesObjRelInsertInput (simplified) factorAddressId: nullable: true title: String type: string factorId: nullable: true title: String type: string fileAssociations: type: object description: FileAssociationsArrRelInsertInput (simplified) id: nullable: true title: String type: string integrationId: nullable: true title: String type: string invoiceErrors: type: object description: InvoiceErrorsArrRelInsertInput (simplified) invoiceNumber: nullable: true title: String type: string issueDate: $ref: '#/components/schemas/date' loadNumber: nullable: true title: String type: string matchingDisabled: nullable: true title: Boolean type: boolean mergedFrom: type: object description: CarrierInvoicesArrRelInsertInput (simplified) mergedIntoCarrierInvoiceId: nullable: true title: String type: string mergedTo: type: object description: CarrierInvoicesObjRelInsertInput (simplified) metadata: $ref: '#/components/schemas/jsonb' notes: type: object description: NotesArrRelInsertInput (simplified) quickPayRequestReasoning: nullable: true title: String type: string quickPayRequestText: nullable: true title: String type: string quickPayRequested: nullable: true title: Boolean type: boolean receivedAt: $ref: '#/components/schemas/timestamptz' referenceNumbers: $ref: '#/components/schemas/jsonb' shipmentId: nullable: true title: String type: string sourceSystem: nullable: true title: String type: string sourceSystemId: nullable: true title: String type: string sourceSystemMeta: $ref: '#/components/schemas/jsonb' status: $ref: '#/components/schemas/CarrierInvoiceStatusEnum' tmsDocumentsUploadStatus: $ref: '#/components/schemas/UploadStatusEnum' totalAmount: nullable: true title: Int type: integer description: >- The total amount of the invoice. This should be in cents. For example, $100.00 should be represented as 10000. totalTaxAmount: nullable: true title: Int type: integer description: >- The total tax amount of the invoice. This should be in cents. For example, $100.00 should be represented as 10000. updatedAt: $ref: '#/components/schemas/timestamptz' title: CarrierInvoicesInsertInput type: object numeric: nullable: false title: numeric timestamptz: nullable: false title: timestamptz type: string format: date-time description: >- A timestamp with timezone in ISO 8601 format, such as 2024-12-16T21:57:14.525733+00:00 CurrencyCodeEnum: enum: - AED - AUD - BRL - CAD - CHF - CNY - EGP - EUR - GBP - HKD - IDR - INR - JPY - KRW - MXN - MYR - NZD - QAR - SAR - SGD - THB - TRY - TWD - USD - VND - ZAR nullable: false title: CurrencyCodeEnum date: nullable: false title: date type: string format: date description: A date string, such as 2024-02-03 (YYYY-MM-DD) jsonb: nullable: false title: jsonb CarrierInvoiceStatusEnum: enum: - APPROVED - AWAITING_BILL - AWAITING_CARRIER_RESPONSE - AWAITING_INVOICE - CANCELLED - CARRIER_EXCEPTION - CARRIER_RESPONDED - DISPUTED - EXCEPTION - PAID - PART_PAID - PROCESSING - RECEIVED - REFUNDED - REJECTED - UNDER_REVIEW nullable: false title: CarrierInvoiceStatusEnum uuid: nullable: false pattern: '[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89aAbB][a-f0-9]{3}-[a-f0-9]{12}' title: uuid type: string timestamp: nullable: false title: timestamp UploadStatusEnum: enum: - FAILURE - INITIATED - PARTIAL_SUCCESS - SUCCESS nullable: false title: UploadStatusEnum ````