---
name: "documents_merge_pdfs"
area: "documents"
title: "Merge PDFs"
price: "$0.01"
method: "POST"
url: "https://api.conecto.chat/v1/tools/documents_merge_pdfs"
mcp_server: "https://api.conecto.chat/mcp/documents"
auth: "Authorization: Bearer <conecto_sk_ key>"
docs_url: "https://conecto.chat/tools/documents/documents_merge_pdfs"
---

# Merge PDFs (`documents_merge_pdfs`)

Makes one PDF from several in the store, in the order given.

One PDF from several in the store, in the order given.

Price: $0.01 a call. A call that fails costs nothing.

## Use it when

Several PDFs should go out as one: an offer pack, a signed bundle.

## Say this to your agent

> Put the quote, the care guide and the fabric samples sheet into one PDF for Hotel Elbblick.

## Inputs

| Name | Type | Required | Description | Allowed values | Default |
|---|---|---|---|---|---|
| `file_ids` | array of strings | yes | 2 to 50 items. |  |  |
| `name` | string | yes | Name for the new file, e.g. "Quote 1042.pdf". 1 to 200 characters. |  |  |
| `link_hours` | integer | no | 1 to 168. |  | `24` |

## Example

Written for Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff.

MCP: call `documents_merge_pdfs` on the MCP server `https://api.conecto.chat/mcp/documents` with these arguments:

```json
{
  "name": "Hotel Elbblick offer.pdf",
  "file_ids": [
    "3a5c7e9b-2d4f-4a6c-8e0b-1d3f5a7c9e2b",
    "4b6d8f0a-3e5a-4b7d-9f1c-2e4a6c8e0b3d",
    "5c7e9a1b-4f6b-4c8e-8a2d-3f5b7d9f1c4e"
  ]
}
```

REST:

```bash
curl https://api.conecto.chat/v1/tools/documents_merge_pdfs \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Hotel Elbblick offer.pdf", "file_ids": ["3a5c7e9b-2d4f-4a6c-8e0b-1d3f5a7c9e2b", "4b6d8f0a-3e5a-4b7d-9f1c-2e4a6c8e0b3d", "5c7e9a1b-4f6b-4c8e-8a2d-3f5b7d9f1c4e"]}'
```

## Response

```json
{
  "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93",
  "tool": "documents_merge_pdfs",
  "status": "succeeded",
  "replayed": false,
  "cost_usd": "$0.01",
  "balance_usd": "$19.75",
  "result": {
    "file": {
      "file_id": "4bfc7b16-2d04-4477-a614-d8c86665dc3a",
      "name": "Hotel Elbblick offer.pdf",
      "content_type": "application/pdf",
      "size": "2.2 KB",
      "size_bytes": 2289,
      "sha256": "ac282849f566bcd2568eabb7f55e80eb944751e8840c8630f2db4b84f3e9b39d",
      "created_at": "2026-10-14T08:00:00+00:00",
      "download_url": "https://cncto.co/d/4bfc7b16-2d04-4477-a614-d8c86665dc3a?t=eyJmIjoiNGJmYzdiMTYtMmQwNC00NDc3LWE2MTQtZDhjODY2NjVkYzNhIiwiZXhwIjoxNzkyMTYxNjAzfQ:1xHMcl:j3WjerZn4IrWlKHPrfSKugWhFrmRGJ0mniZGbivk-Mg",
      "link_expires_in_hours": 24
    },
    "pages": 6
  }
}
```

`result`: file: the merged PDF with its file_id, name, size and download link; and pages.

## Errors

| Code | Status | When | Fix |
|---|---|---|---|
| `not_found` | 404 | No file in the store has that file_id. | Find it with files_list, or upload it first. |
| `invalid_pdf` | 422 | One of the PDFs could not be merged (damaged or password-protected). | Leave that PDF out, or open and save it again. |
| `too_large` | 413 | The PDFs are too large together. | Merge fewer at a time. |
| `storage_full` | 409 | The file store has no room for the new file. | Delete files with files_delete, or add room with files_add_storage. |

The refusals every tool can give (401 key, 402 balance, 429 limits) are on the errors page: https://conecto.chat/docs/errors.md

## Related

- [documents_create_pdf](https://conecto.chat/tools/documents/documents_create_pdf.md): Makes a PDF from Markdown or HTML and saves it in the file store with a download link. $0.02 a call.
- [documents_convert_to_pdf](https://conecto.chat/tools/documents/documents_convert_to_pdf.md): Turns a Word, Excel, PowerPoint, OpenDocument, RTF, CSV, text, Markdown or HTML file into a PDF; the original stays. $0.02 a call.
- [documents_template_fields](https://conecto.chat/tools/documents/documents_template_fields.md): The placeholders in a Word (.docx) template, so you know what data filling it needs. Free up to 1,000,000 reads a month.
- [documents_fill_template](https://conecto.chat/tools/documents/documents_fill_template.md): Makes a new Word file from a .docx template, its placeholders filled from data. $0.02 a call.
- [documents_read_pdf](https://conecto.chat/tools/documents/documents_read_pdf.md): The text of a PDF in the store, page by page, up to 50 pages a call. Free up to 1,000,000 reads a month.
- [documents_page_images](https://conecto.chat/tools/documents/documents_page_images.md): The pages of a scanned PDF or a photo of a document as images to look at, up to 10 pages a call. $0.005 a call.
- [documents_create_deck](https://conecto.chat/tools/documents/documents_create_deck.md): A PowerPoint deck from your slides, plain or in the business's template, with editable charts, tables and each slide's sources. $0.10 a call.