![\"Raymond](\"https:\/\/miro.medium.com\/v2\/resize:fill:88:88\/1*ldF-FsLonNyTUOmQ7cIV_g.jpeg\")
<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/a><\/p>\n <\/a><\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n Watermarks provide an important feature for PDFs by allowing you to \u2018mark\u2019 a document. This can be used to signify who the document was created for, specify the status of content, add important information about the document, and so forth. Today we\u2019re happy to announce that Acrobat Services has released the PDF Watermark API, currently available via our REST API<\/a> and soon supported via our various SDKs. Let\u2019s demonstrate this in action.<\/p>\n At a high level, adding watermarks is a three-step process.<\/p>\n Note that like other Acrobat Services, you can use cloud-based storage instead of uploading assets.<\/p>\n We\u2019ve covered the basics of our REST API before, but if you\u2019ve missed that, you can read the introduction here: Announcing the New Adobe Document Services REST APIs<\/a>. As the basics of authentication and asset uploading haven\u2019t changed in two years, we\u2019ll skip over that code and instead focus on how easy it is to kick off the watermark job. Given that you\u2019ve uploaded a source PDF:<\/p>\n And given an uploaded PDF to use for watermarking:<\/p>\n You can make a request to kick off a watermarking job like so:<\/p>\n Note that this example only uses the required arguments specifying our input (the first PDF shown above) and our watermark (the second PDF shown above).<\/p>\n Again, as with our other APIs, this returns a \u201cjob\u201d URL that you can make a request to and check the status. When the job successfully completes, you can then download the result. (Note that as with our other APIs, specifying a webhook URL is also supported.)<\/p>\n You can find the complete source for this below:<\/p>\n As mentioned above, currently the PDF Watermark API only supports static PDF sources for the actual watermark, however, we already support a way to create dynamic PDFs with the Document Generation API<\/a>. If you\u2019ve never encountered it before, this API lets you use a Microsoft Word document as a template. In the Word doc, you can insert tokens that when passed to the API along with your data, will be replaced with real values in the generated PDF. The API supports simple variable substitutions along with more complex use cases involving looping, conditionals, dynamic tables and so forth. For our need here though we can keep it simple. Here\u2019s a Word document we\u2019ll use as a watermark:<\/p>\n In the Word document above, the section, How is that done? First, we upload our source Word document and then we can call the Document Generation API:<\/p>\n This snippet skips over a bit of stuff we\u2019ve already covered, but you can see the call to the REST API passing the asset ID of the uploaded Word document along with our data, which in this case is just an email address.<\/p>\n Now, here comes the fun part. We don\u2019t have to actually download the generated PDF. The result, For this demo, we modified the opacity in our Watermark API call to specify a lower opacity:<\/p>\n Once run and the result stored, here\u2019s the result:<\/p>\n You can find the complete source code for this example here: https:\/\/github.com\/cfjedimaster\/document-services-demos\/blob\/main\/watermark\/dynamic.js<\/a><\/p>\n If you want to give this API, and the many other features of Acrobat Services, sign up for your credentials<\/a> and start using the free tier today. If you need help, reach out on our forums<\/a>.<\/p>\n<\/div>\n![\"Adobe](\"https:\/\/miro.medium.com\/v2\/resize:fill:48:48\/1*riyFijvwTfGcWNf1guRNtg.png\")
<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n\n
![\"Screenshot](\"https:\/\/miro.medium.com\/v2\/resize:fit:640\/format:webp\/1*WZmoYN96iF_GvNVgf52YQg.png)
![\"Screenshot](\"https:\/\/miro.medium.com\/v2\/resize:fit:640\/format:webp\/1*FUdXfIIgSFgQDQudYSpRjg.png)
![\"Sample](\"https:\/\/miro.medium.com\/v2\/resize:fit:640\/format:webp\/1*Q1q5hqN7ZGH6h1PyAG41Tg.png)
![\"Word](\"https:\/\/miro.medium.com\/v2\/resize:fit:640\/format:webp\/1*4gbqcZt2GyxrU9g1M6X7mw.png)
{{ email }}<\/code> will be replaced with a real value when the Document Generation API is called. We can then take the result of that<\/em> call and use it to watermark another PDF.<\/p>\ndocgenResult<\/code>, contains an asset object and we can simply use that in our Watermark call:<\/p>\n![\"Watermarked](\"https:\/\/miro.medium.com\/v2\/resize:fit:640\/format:webp\/1*tYl53e9mmwQxUic32HPxlA.png)