Watermark

Welcome to the Watermark API documentation—a streamlined solution that lets you embed custom watermark text directly into a wide variety of spreadsheet formats with a single, developer‑friendly request. Whether you're working with Microsoft Excel files (.xlsx, .xls, .xlsm), classic CSV and TSV files, Apple Numbers (.numbers), or many other supported types, our API handles the heavy lifting for you. Simply upload the source file, provide the desired watermark text, and let our secure, high‑performance service return a watermarked version ready for distribution. This capability is perfect for adding brand logos, version identifiers, confidentiality notices, or any custom label that reinforces document control and authenticity across your organization.

Main Features

Designed with speed and security at its core, the Watermark API integrates seamlessly into any existing workflow, whether you're building a cloud‑based SaaS platform, an internal file‑management tool, or an automated reporting pipeline. The endpoint accepts multipart uploads, validates file integrity, and applies the watermark with precision, ensuring that the original data layout remains unchanged while the added text is clearly visible. Because it's built for developers, you'll find clear error messages, comprehensive response codes, and thorough example requests throughout this guide. Dive in to discover how a single API call can protect your spreadsheets, enhance brand consistency, and simplify document lifecycle management.

Documents

Parameters

AppRequest.WatermarkText: If you want to use Rgb color fill this input whatelse please use Hex color
AppRequest.WatermarkColorHex: If you want to use Rgb color fill this input whatelse please use Hex color
AppRequest.WatermarkTextRGB: If you want to use Rgb color fill this input whatelse please use Hex color
UploadFileRequest.OperationId: This is an operation id
UploadFileRequest.Files: These are files you need to upload them to our online services, you can prepare the data in your very own way but it must follow the standard of the html input file.

Use The Endpoint

Send a request that includes the files and the access token Watermark API

curl -X 'POST' \ 'https://api.sheetize.cloud/watermark' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -F 'AppRequest.WatermarkText=TheWatermarkText' \ -F 'AppRequest.WatermarkColorHex=ff0000' \ -F 'UploadFileRequest.OperationId=' \ -F 'UploadFileRequest.Files=@AFileName.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
The service will respond with a download URL for the processed file, in this example it is:

{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/TheFolderName/TheFileName.xlsx", "message": "", "statusCode": 200 }
Send a request that includes the file name and the folder name to Download API

curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.xlsx' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken'
You will receive the file and you can either use it or simply forward it to the next step of your workflow.