---
title: "Create a transaction upload URL"
method: POST
path: "/v3/spend/transactions/receipt-upload-url"
tags: ["transactions"]
---

# Create a transaction upload URL

`POST /v3/spend/transactions/receipt-upload-url`

## Request

- Base URL: `https://gateway.stage.bill.com/connect`
- URL: `https://gateway.stage.bill.com/connect/v3/spend/transactions/receipt-upload-url`
- Auth: none declared

Create a transaction image upload URL.

From the response, use the upload `url` to upload a receipt image for the transaction. For example, to upload a JPEG image, use the following `curl` command. To upload a PNG image, set the content type as `image/png`.

```
curl '{upload_url}'
-H 'Content-Type: image/jpeg'
--upload-file {file_name_with_extension}
```

**Note**: BILL supports JPG and PNG file formats for transaction images.

See [Transactions](https://developer.bill.com/docs/transaction-management) in the Guides section for more information, sample requests, and responses.

## Headers

- `apiToken` string, nullable: Access token for Spend & Expense API authentication

## Response `200`

Create a transaction upload URL response

- ReimbursementImageUploadUrlResponseDto: API response for creating a reimbursement image upload URL.
  - `url` string: Pre-signed URL for uploading a receipt

## Other responses

- `4XX`: List of errors.
- `5XX`: List of errors.

## Changes

- **2026-11-03** `54edddceb0a5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bill/apis/bill-v3-api/changes/v3/spend/transactions/receipt-upload-url/post.md)

---

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