---
title: "Start a provider portal invoice upload"
method: POST
path: "/api/v1/remittance_portal/invoice_uploads"
---

# Start a provider portal invoice upload

`POST /api/v1/remittance_portal/invoice_uploads`

## Request

- Base URL: `https://api.caresquare.com.au` (the document declares no server; this is the origin it was published from)
- URL: `https://api.caresquare.com.au/api/v1/remittance_portal/invoice_uploads`
- Auth: none declared

Records an invoice_uploads row for the logged-in provider and returns a presigned PUT for the manual-upload bucket. The document handler processes the file as an _M1 upload.

## Request body

- CreateInvoiceUploadRequest
  - `plan_manager_id` string, required
  - `pm_provider_id` string, required
  - `provider_email` string, required
  - `auth_user_id` string, nullable
  - `file_name` string, required
  - `file_size` integer, required
  - `content_type` 'application/pdf' | 'image/png' | 'image/jpeg' | 'application/msword' | 'application/vnd.openxmlformats-officedocument.wordprocessingml.document' | 'application/vnd.ms-excel' | 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' | 'text/csv', required
  - `ip_address` string, nullable
  - `user_agent` string, nullable
  - `origin_host` string, nullable

## Response `201`

Successful Response

- CreateInvoiceUploadResponse
  - `upload_id` string, required
  - `upload_url` string, required
  - `upload_headers` object, required
  - `expires_in` integer, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-30** `d3b9f3fd5bfd`: 5 info
  - added the new `application/msword` enum value to the request property `content_type`
  - added the new `application/vnd.ms-excel` enum value to the request property `content_type`
  - added the new `application/vnd.openxmlformats-officedocument.spreadsheetml.sheet` enum value to the request property `content_type`
  - added the new `application/vnd.openxmlformats-officedocument.wordprocessingml.document` enum value to the request property `content_type`
  - …1 more
- **2026-10-30** `8de613a77872`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/caresquare/apis/caresquare-api/changes/api/v1/remittance_portal/invoice_uploads/post.md)

---

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