AnyConvert
← All docs

Watermark PDF

Send a PDF and a text or image stamp; get back the same PDF with that stamp placed at the position, rotation, and opacity you choose.

See the Watermark PDF tool page, or the docs index for authentication, the shared request/webhook contract, and the generic error table.

Request

POST /webhooks/trigger — same endpoint and fields as every tool, with tool="watermark-pdf" set explicitly (it's not the default).

curl
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=watermark-pdf"

Options

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. Coordinates and positions are as the page is displayed (after rotation), in points from the top-left.

typestring, required"text" or "image".
textstring, text only1 to 200 characters. Checked against the chosen font before drawing — a missing character fails rather than being dropped silently.
font, bold, italictext onlyhelvetica, times, courier, sans, serif, or mono.
sizenumber, text only6 to 400pt.
colorstringHex #RRGGBB.
opacitynumber0.05 to 1.
rotationnumber-180 to 180 degrees, counter-clockwise as displayed.
positionstringOne of 9 anchors (center, corners, edge midpoints), with an optional marginPt (default 36).
tilebooleanRepeat the stamp on a grid instead of placing it once.
layerstring"over" (default) or "under" the page content.
pagesstring, optionalDefault "all"; the page-selection grammar (1-3,7, odd, last, etc.).
image (for type: "image")—Sent as a second file part named "watermark" (PNG with alpha, or JPEG) rather than inline base64, plus widthPercent (1-100 of the page width, aspect ratio always preserved).

Pricing

Billed per page, not per document — 1 credit for every 20 pages, rounded up.

Failure reasons

Delivered via the webhook as outcome=failure with a reason below — see the docs index for the full delivery shape.

invalid_optionsA missing glyph, an image over the size limit, a bad position/rotation value, or a page outside the document.
invalid_fileThe file could not be read, or was not the format this tool expects.
render_failedSomething failed during conversion that wasn’t a problem with the input itself.
timeoutThe job did not finish within its time budget.
internal_errorAn unexpected error on our side.
AnyConvert
A simple conversion API for teams that need documents turned into the right format, automatically.
Tools
PDF to WordMerge PDFJPG to PDFSign PDFEdit PDFCompress PDFExtract Text with CoordinatesView all tools →
Product
DocsPricing
Legal
Terms of ServicePrivacy PolicyRefund Policy
Support
support@anyconvert.app
© 2026 AnyConvert. All rights reserved.