---
title: "Upload an attachment"
method: POST
path: "/v1/attachments"
tags: ["attachments"]
---

# Upload an attachment

`POST /v1/attachments`

Upload a file (PDF, DOCX, image, etc.) and receive a hashed <code>attachmentId</code>. Pass that <code>attachmentId</code> in the <code>attachmentIds[]</code> of an Email-step variant when creating or updating a step to attach the file to outgoing emails. For attachments referenced from a note, use <code>POST /v1/notes/attachments</code> instead.

<strong>Content-Type</strong>: <code>multipart/form-data</code> with a single <code>file</code> field.

## Response `201`

Attachment uploaded

## Other responses

- `400` — 4000: Failed to upload attachment<br><br>

---

[API](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy.md) · [All operations](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/saleshandy/develop-with-saleshandy/revisions/fdaa0f2dcdfb/schema)