☁️ GroupDocs.Watermark Cloud

Document Watermark Cloud API for Text & Image Marks

GroupDocs.Watermark Cloud is an enterprise-grade REST API for adding, searching, and removing watermarks. Protect documents and images with text or image watermarks, control placement and styling, and automate watermark workflows — with no third-party desktop software.

📂 Cloud SDKs & Repositories

SDKs are grouped by platform. Each example adds a text watermark using the Add Text Watermarks API. The same call is shown first as plain REST (cURL), then for each available SDK.

📡 cURL (REST API)

Call the Watermark Cloud REST API directly (no SDK). Obtain a JWT from the token endpoint (client_credentials), then add a watermark:

# Get JWT (Client Id / Client Secret from https://dashboard.groupdocs.cloud)
curl -v "https://api.groupdocs.cloud/connect/token" \
  -X POST \
  -d "grant_type=client_credentials&client_id=$CLIENT_ID&client_secret=$CLIENT_SECRET" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -H "Accept: application/json"

# Add a text watermark
curl -v "https://api.groupdocs.cloud/v1.0/watermark" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $JWT_TOKEN" \
  -d '{
    "FileInfo": {
      "FilePath": "documents/sample.pdf"
    },
    "WatermarkDetails": [
      {
        "TextWatermarkOptions": {
          "Text": "Watermark text",
          "FontFamilyName": "Arial",
          "FontSize": 20.0,
          "ForegroundColor": {
            "Name": "red"
          },
          "TextAlignment": "center",
          "Padding": {
            "Left": 0,
            "Top": 0,
            "Right": 0,
            "Bottom": 0
          }
        },
        "Position": {
          "X": 0.0,
          "Y": 0.0,
          "Width": 0.0,
          "Height": 0.0,
          "HorizontalAlignment": "Center",
          "RotateAngle": 0.0,
          "ConsiderParentMargins": false,
          "IsBackground": false
        }
      }
    ]
  }'

See more: Add Text Watermarks (cURL example).

🌐 .NET (C#, ASP.NET)

.NET SDK for GroupDocs.Watermark Cloud — .NET Core and .NET Framework.

• groupdocs-watermark-cloud-dotnet — SDK
• groupdocs-watermark-cloud-dotnet-samples — Examples

var configuration = new Configuration(MyClientId, MyClientSecret);
var apiInstance = new WatermarkApi(configuration);

var options = new WatermarkOptions
{
    FileInfo = new FileInfo { FilePath = "documents/sample.docx" },
    WatermarkDetails = new List<WatermarkDetails>
    {
        new WatermarkDetails
        {
            TextWatermarkOptions = new TextWatermarkOptions
            {
                Text = "New watermark text",
                FontFamilyName = "Arial",
                FontSize = 12d
            }
        }
    }
};
var response = apiInstance.Add(new AddRequest(options));

☕ Java

Java SDK for the GroupDocs.Watermark Cloud REST API.

• groupdocs-watermark-cloud-java — SDK
• groupdocs-watermark-cloud-java-samples — Examples

Configuration configuration = new Configuration(MyClientId, MyClientSecret);
WatermarkApi apiInstance = new WatermarkApi(configuration);

FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("documents/sample.docx");

TextWatermarkOptions textWatermarkOptions = new TextWatermarkOptions();
textWatermarkOptions.setText("New watermark text");
textWatermarkOptions.setFontFamilyName("Arial");
textWatermarkOptions.setFontSize(12d);

WatermarkDetails watermarkDetails = new WatermarkDetails();
watermarkDetails.setTextWatermarkOptions(textWatermarkOptions);

WatermarkOptions options = new WatermarkOptions();
options.setFileInfo(fileInfo);
options.setWatermarkDetails(Arrays.asList(watermarkDetails));

WatermarkResult response = apiInstance.add(new AddRequest(options));

---

Business Use Cases

• Confidential marking — Stamp “Confidential” or “Internal” on every page before sharing.
• Brand protection — Overlay logos or company names on marketing PDFs and images.
• Draft control — Watermark work-in-progress documents so they are not mistaken for finals.
• Leak deterrence — Embed user or case identifiers as searchable text watermarks.
• Batch automation — Apply consistent watermarks from serverless jobs on upload.

---

🔑 API Key & Authentication

Use Client ID and Client Secret from GroupDocs Cloud Dashboard to authenticate. Set them in your SDK configuration (e.g. Configuration, from_keys, or environment variables) before calling the API.

---

✅ Key Features & Benefits

Feature	Description
Text & image watermarks	Add styled text or image overlays to documents and images.
Positioning	Control alignment, rotation, size, and background/foreground placement.
Search & remove	Find existing watermarks and remove them when needed.
Password-protected files	Open protected documents by supplying a password.
Format-specific options	Leverage format features for stronger watermarking.
Cloud storage	Upload, download, and manage files used by watermark operations.

---

🆘 Technical Support & Resources

Resource	Link
Documentation	GroupDocs.Watermark Cloud Docs — guides, API reference, and SDK usage.
Support forum	GroupDocs Cloud Free Support Forum — ask questions and report issues.
Temporary license	Get a free trial — full-feature evaluation.
Live demo	GroupDocs.Watermark apps — try watermarks in the browser.
API reference	REST API Reference — Swagger/OpenAPI.

---

🏷️ Tags

document-watermark text-watermark image-watermark pdf-watermark protect-document brand-watermark watermark-api groupdocs-watermark-cloud watermark-sdk confidential-mark