Send a PDF and one or more signature-field placements; get back the same PDF with empty, fillable signature fields added at those exact positions.
See the Sign 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="sign-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=@agreement.pdf" \ -F "fileId=document-001" \ -F "referenceId=reference-001" \ -F "tool=sign-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. Adds empty signature fields for signing elsewhere; it does not apply a cryptographic signature itself.
| mode | string, optional | Only "field" is supported (the default). |
| placeholder | boolean, optional | Default true: draw a visible empty-signature placeholder. false leaves the field invisible until a viewer highlights it. |
| fields | array, required | 1 to 50 entries, each a field to add. |
| fields[].name | string, optional | Letters, digits, _, -, 1-64 characters. Must be unique and not collide with an existing field in the PDF. |
| fields[].page | number, required | 1-based page number within the document. |
| fields[].rect | object, required | { x, y, width, height } in points, as the page is displayed (top-left origin). Minimum 20×10, and the whole rectangle must lie inside the page. |
| fields[].signer | object, optional | Optional name (max 100) and email (max 200), used only for the field's tooltip. |
Billed per document: $1 (1 credit) per signed PDF, regardless of field count.
Delivered via the webhook as outcome=failure with a reason below; see the docs index for the full delivery shape.
| invalid_options | A bad option, a page or rectangle out of range, a duplicate/colliding field name, or mode: "sign". |
| encrypted_file | The PDF is password protected. |
| 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. |