Send two or more PDFs as repeated file parts, in the order you want them combined; get the merged PDF delivered to your webhook.
See the Merge PDF tool page, or the docs index for authentication, the shared request/webhook contract, and the generic error table.
POST /webhooks/trigger, same endpoint and fields as every tool, with tool="merge-pdf" set explicitly (it's not the default).
curl -X POST https://api.anyconvert.app/webhooks/trigger \ -H "x-api-key: your_api_key_here" \ -F "file=@report.pdf" \ -F "fileId=document-001" \ -F "referenceId=reference-001" \ -F "tool=merge-pdf"
An optional options multipart field carrying a JSON object, validated synchronously before a credit is charged; a bad value is rejected with 400, not charged and not queued.
| bookmarks | string, optional | "none" (default) or "files": add one top-level bookmark per source file. |
| titles | string[], optional | One title per input file (used with bookmarks: "files"), each up to 200 characters. |
| pageRanges | string[], optional | One range per input file, e.g. "1-3,5", to merge only those pages from that file. |
| passwords | string[], optional | One password per input file, for any that are encrypted. |
| onBadInput | string, optional | "fail" (default) or "skip": skip an unreadable input instead of failing the whole merge. |
| metadata | object, optional | Only title and author keys, set on the merged output. |
Send the file field multiple times in the same request (up to 200 files), one per PDF, in merge order. A single file still works as before.
Billed per document, not per input file: $1 (1 credit) per merge, however many PDFs you combine.
Delivered via the webhook as outcome=failure with a reason below; see the docs index for the full delivery shape.
| encrypted_file | An input is password protected and no matching password was given. |
| invalid_file | The file could not be read, or was not the format this tool expects. |
| render_failed | Something failed during conversion that wasn’t a problem with the input itself. |
| timeout | The job did not finish within its time budget. |
| internal_error | An unexpected error on our side. |