Apply watermark to an image
Apply a watermark to an image using either a specific template ID or by resolving the template bound to a specific connected account.
If the same watermark + image combination has been processed before, the response returns immediately with status: completed and the output URL in message. Otherwise, processing is queued and the response returns status: pending with a progressId.
Rate limits: This endpoint may be rate-limited to prevent abuse. To resolve a template dynamically at publish time, pass accountId — the endpoint will resolve the template bound to that connected account. Use the Get Accounts endpoint to look up account IDs.
Processing is asynchronous — the response returns a progressId that identifies this preview job.
Document fields:
status: 'pending' | 'processing' | 'completed' | 'failed'outputMediaUrl: string, available whenstatusiscompletederrorMessage: string, available whenstatusisfailed
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your access token.
socialplanner/ watermarks. writeOAuthPrivate IntegrationSub-Account TokenRequest
Headers
API Version
v3v3Path Parameters
Location Id
ve9EPM428h8vShlRW1KTBody
Template ID to apply. Required if accountId is not provided.
665f1bac78fda9b6c5f48012Connected account ID — the endpoint will resolve the template bound to this account. Required if templateId is not provided. Use the Get Accounts endpoint to look up account IDs.
665f1bac78fda9b6c5f48099Input media URL (either video or image)
http://example.com/media.mp4MIME type of the media
image/jpegimage/jpgimage/pngimage/gifimage/bmpimage/webpimage/tiffimage/svg+xmlimage/vnd.microsoft.iconimage/heicimage/heifvideo/mp4image/pngOptional post ID to associate the watermark output with
ve9EPM428h8vShlRW1KTOptional cache key to fetch a previously-generated watermark result
ve9EPM428h8vShlRW1KTWhether to update or create the linked post after watermarking
falseResponse
Watermark processing initiated or cached result returned.
Success or Failure
trueStatus Code
201Message
Created Watermark ImageAsync processing result