---
title: "Add an Item to a Bulk Import"
method: POST
path: "/v1/web/bulk-import/{bulkImportId}/items"
tags: ["Bulk Import"]
---

# Add an Item to a Bulk Import

`POST /v1/web/bulk-import/{bulkImportId}/items`

Only allowed while the bulk import is `ready`.

## Path parameters

- `bulkImportId` string, required

## Request body

- union
  - object
    - `type` 'createBillLineItem', required
    - `request` object, required
      - `invoiceId` string
      - `currencyCode` string
      - `invoiceDate` string
      - `paymentDueDate` string
      - `totalAmount` string
      - `externalId` string
      - `vendorId` string
      - `vendorName` string
      - `description` string
      - `lineItem` object
        - `description` string
        - `amount` string
  - object
    - `type` 'createVendor', required
    - `request` object, required
      - `name` string
      - `externalId` string
      - `currencyCode` string
      - `country` string
      - `contact` object
        - `name` object
          - `firstName` string
          - `middleName` string
          - `lastName` string
        - `email` string
        - `phone` string

## Response `201`

Default Response

- union
  - object
    - `id` string, required
    - `status` union, required
      - 'ready'
      - 'processing'
      - 'imported'
      - 'skipped'
      - 'failed'
    - `imported` object
      - `billId` string, required
      - `billLineItemId` string, required
    - `type` 'createBillLineItem', required
    - `request` object, required
      - `invoiceId` string
      - `currencyCode` string
      - `invoiceDate` string
      - `paymentDueDate` string
      - `totalAmount` string
      - `externalId` string
      - `vendorId` string
      - `vendorName` string
      - `description` string
      - `lineItem` object
        - `description` string
        - `amount` string
    - `validation` object, required
      - `status` union, required
        - 'pending'
        - 'valid'
        - 'invalid'
      - `errors` object[], required
        - `code` union, required
          - 'invalidCurrencyCode'
          - 'invalidInvoiceDate'
          - 'invalidPaymentDueDate'
          - 'invalidPaymentScheduledDate'
          - 'invalidTotalAmount'
          - 'invalidVendorId'
          - 'invalidAmount'
          - 'invalidInvoiceId'
          - 'notFound'
          - 'invalidStatus'
        - `level` union, required
          - 'info'
          - 'warn'
          - 'error'
        - `message` string
    - `processingErrors` object[], required
      - `code` 'internal', required
      - `message` string
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - object
    - `id` string, required
    - `status` union, required
      - 'ready'
      - 'processing'
      - 'imported'
      - 'skipped'
      - 'failed'
    - `imported` object
      - `vendorId` string, required
    - `type` 'createVendor', required
    - `request` object, required
      - `name` string
      - `externalId` string
      - `currencyCode` string
      - `country` string
      - `contact` object
        - `name` object
          - `firstName` string
          - `middleName` string
          - `lastName` string
        - `email` string
        - `phone` string
    - `validation` object, required
      - `status` union, required
        - 'pending'
        - 'valid'
        - 'invalid'
      - `errors` object[], required
        - `code` union, required
          - 'invalidName'
          - 'invalidCurrencyCode'
          - 'invalidCountry'
          - 'invalidContactName'
          - 'invalidContactEmail'
          - 'invalidRutterId'
        - `level` union, required
          - 'info'
          - 'warn'
          - 'error'
        - `message` string
    - `processingErrors` object[], required
      - `code` 'internal', required
      - `message` string
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required

## Other responses

- `400` — Default Response
- `401` — The access to this resource has been denied
- `403` — The access to this resource is forbidden
- `404` — The resource was not found
- `default` — Catch-all error response for any unexpected internal errors

---

[API](https://skmtc.net/funneldash/apis/surface-web-api.md) · [All operations](https://skmtc.net/funneldash/apis/surface-web-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/funneldash/surface-web-api/revisions/ac700d65f443/schema)