# Merge Documents (Sync)

Combine multiple PDF, DOCX, PNG, or JPEG files into a single consolidated document synchronously from Apex.

> Kind: Apex method · Updated: 2026-07-01

## Signature

```apex
global static List<GeneratedDocument> mergeDocumentsSync(
  List<Types.MergeDocumentsRequestInput> payloads,
  String runAs
)
```

### Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| payloads | List&lt;<a href="#/apex-type-merge-documents-request-input">Types.MergeDocumentsRequestInput</a>&gt; | required | List of Types.MergeDocumentsRequestInput. One entry per merge request. |
| runAs | String | optional | Username to attribute the operation to; usually a static value such as integrationUser. |

## Return Type

List<GeneratedDocument&gt; — the merged output document(s).

## Example

```apex
cldfs.Resource destination = new cldfs.Resource('01KEHAKUVATUH5R5QRKJBLR3ITM3E6VCXN', null, null, 'sharepoint', 'b!nJBtPq_z5UeJtFrj_f24XEQqlPUD8vtFsg7GBcrXJepiUn9bkb_7QbDPtqHVD-cP');
List<cldfs.Resource> resourcesToMerge = new List<cldfs.Resource>{
    new cldfs.Resource('01KEHAKUVVZCAVRDFCTJAZGEHHVIECEE5S', 'file', 'Empty Doc.docx', 'sharepoint', 'b!nJBtPq_z5UeJtFrj_f24XEQqlPUD8vtFsg7GBcrXJepiUn9bkb_7QbDPtqHVD-cP'),
    new cldfs.Resource('01KEHAKUQ6HPTOXBHSBVALO5N4DE6VXNTT', 'file', 'Empty Pdf.pdf', 'sharepoint', 'b!nJBtPq_z5UeJtFrj_f24XEQqlPUD8vtFsg7GBcrXJepiUn9bkb_7QbDPtqHVD-cP')
};
List<cldfs.Types.MergeDocumentsRequestInput> payloads = new List<cldfs.Types.MergeDocumentsRequestInput>{
    new cldfs.Types.MergeDocumentsRequestInput(
        resourcesToMerge,
        'Test Merge',
        destination
    )
};
List<cldfs.GeneratedDocument> GeneratedDocument = cldfs.Client.mergeDocumentsSync(payloads, 'integrationUser');
```