---
title: "Create Citation With Attachment"
method: POST
path: "/references/folder/citations/with-attachment"
tags: ["References"]
---

# Create Citation With Attachment

`POST /references/folder/citations/with-attachment`

Creates a new manual citation and uploads a file attachment in a single atomic operation. If the file upload or attachment recording fails, the citation is rolled back automatically.

The file is scanned for malware before upload. Infected files are rejected and no citation is created.

**Required fields:** `folderId`, `title`, `isMain`, `file`.

**Optional citation fields:** `publicationName`, `publicationDate`, `author`, `notes`, `abstract`, `doi`, `pmid`, `standardNumber1`, `standardNumber2`, `pages`, `issue`, `volume`, `subFolderId`, `tagsId`.

**IsMain:** 0 = secondary attachment, 1 = primary attachment. 

Supports both numeric and GUID folder IDs.

**Maximum file size: 100 MB.**

## Response `200`

Citation and attachment processed.

- CitationAttachmentCreatedResult
  - `folderId` string, nullable — Echo of the folder identifier from the request.
  - `citationId` string, nullable — Echo of the citation identifier from the request.
  - `attachmentId` string, nullable — The generated attachment identifier (numeric or 32-character hex GUID). Null when Success is false.
  - `success` boolean — Indicates whether the attachment was uploaded and recorded successfully.
  - `error` string, nullable — Error description when Success is false. Null when the operation succeeds.

---

[API](https://skmtc.net/researchsolutions/apis/article-galaxy-api.md) · [All operations](https://skmtc.net/researchsolutions/apis/article-galaxy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/researchsolutions/article-galaxy-api/revisions/70fb92d278f5/schema)