---
title: Creating a Document Overlay via API with Flow Service
description: Description Integration to PDCflow’s Flow Service enables companies to send requests for signatures, payments, document review and/or image requests.  Integrators can also generate new Document Overla
---

[Skip to content](https://support.pdcflow.com/creating-a-document-overlay-via-api-with-flow-service#main-content)

English

Show submenu for translations

[![pdcflow\_logo\_horizontal\_full\_color\_expanded](https://support.pdcflow.com/hs-fs/hubfs/PDCflow%20Logos/pdcflow_logo_horizontal_full_color_expanded.png?width=300&height=100&name=pdcflow_logo_horizontal_full_color_expanded.png)](https://support.pdcflow.com/?hsLang=en)

Open main navigation

Close main navigation

- English
  
  Show submenu for translations
- [App Login](https://app.pdcflow.com/)

[App Login](https://app.pdcflow.com/)

 Welcome to PDCflow's Help Center

- There are no suggestions because the search field is empty.

1. [PDCflow Help Center](https://support.pdcflow.com/?hsLang=en)
2. [API Documentation](https://support.pdcflow.com/api-documentation?hsLang=en)

# Creating a Document Overlay via API with Flow Service

**Description**

Integration to PDCflow’s Flow Service enables companies to send requests for signatures, payments, document review and/or image requests. 

Integrators can also generate new Document Overlays entirely within their integration. 

**How to Add a New Document Overlay via Flow Service**

To create an overlay, provide an originalDocumentId, overlayName and a list of overlayBoxDefinitions in an HTTP POST request to:[https://wssignaturedemo.pdc4u.com/SignatureService/api/v2\_0/overlays](https://wssignaturedemo.pdc4u.com/SignatureService/api/v2_0/overlays)

The overlay is a configuration of "overlayBoxDefinition"s. You will define where each box is placed in relation to the document page, then the saved overlay can be used with any document by referencing the overlayId in the Flow request.

The originalDocumentId is required and is used within FLOW UI to show the original document the overlay was created for. If you went back and edited an overlay it would load the original document for editing purposes.

PDCflow supports a specific set of boxTypes, including:

- SIGNATURE
- DATE
- CHECK
- TEXT

SIGNATURE box type has two definitions, including:

- small signature
- large signature

**What Your Process May Look Like**

1. Upload a document you want to create an overlay for and keep the documentId.
2. Retrieve list of overlayBoxTypes with HTTP GET request from https: [wssignaturedemo.pdc4u.com/SignatureService/api/v2\_0/overlayboxtypes](http://wssignaturedemo.pdc4u.com/SignatureService/api/v2_0/overlayboxtypes)
3. This will give you a list of five box types, their dimensions (height, width), and the overlayBoxTypeId which you will use in the request to create an overlay.
4. Allow users to place which boxes they would like on a document.
5. Pass the coordinates and box types of those values to the Flow Service to define the overlay.

For more information, please refer to the "Overlay Creation" section of the sample code within our API Documentation: [https://apidocs.pdcflow.com/#sample-code140](https://apidocs.pdcflow.com/#sample-code140)

 

#### Need Help?

Email our Customer Success team at [support@pdcflow.com](mailto:support@pdcflow.com).

- [Getting Started](https://support.pdcflow.com/getting-started?hsLang=en#main-content)

    - [Demos](https://support.pdcflow.com/getting-started?hsLang=en#demos)
- [Flow Requests](https://support.pdcflow.com/flow-requests?hsLang=en)
- [Payments / Transactions](https://support.pdcflow.com/payments-transactions?hsLang=en#main-content)

    - [Credit Card Payments](https://support.pdcflow.com/payments-transactions?hsLang=en#credit-card-payments)
    - [Check (ACH) Payments](https://support.pdcflow.com/payments-transactions?hsLang=en#check-ach-payments)
    - [Cash Payments](https://support.pdcflow.com/payments-transactions?hsLang=en#cash-payments)
    - [Portals](https://support.pdcflow.com/payments-transactions?hsLang=en#portals)
    - [Payment Schedules](https://support.pdcflow.com/payments-transactions?hsLang=en#payment-schedules)
- [Reporting](https://support.pdcflow.com/reporting?hsLang=en#main-content)

    - [Financial Reports](https://support.pdcflow.com/reporting?hsLang=en#financial-reports)
    - [Check Posting Reports](https://support.pdcflow.com/reporting?hsLang=en#check-posting-reports)
    - [Schedules Reports](https://support.pdcflow.com/reporting?hsLang=en#schedules-reports)
- [Configuring PDCflow](https://support.pdcflow.com/configuring-pdcflow?hsLang=en#main-content)

    - [Configuring App Settings](https://support.pdcflow.com/configuring-pdcflow?hsLang=en#configuring-app-settings)
    - [Configuring App Users](https://support.pdcflow.com/configuring-pdcflow?hsLang=en#configuring-app-users)
    - [Configuring Flow Components](https://support.pdcflow.com/configuring-pdcflow?hsLang=en#configuring-flow-components)
- [API Documentation](https://support.pdcflow.com/api-documentation?hsLang=en)
- [Leaving PDCflow](https://support.pdcflow.com/leaving-pdcflow?hsLang=en)

[![pdcflow\_logo\_horizontal\_full\_color\_expanded](https://support.pdcflow.com/hs-fs/hubfs/PDCflow%20Logos/pdcflow_logo_horizontal_full_color_expanded.png?width=300&height=100&name=pdcflow_logo_horizontal_full_color_expanded.png "pdcflow_logo_horizontal_full_color_expanded")](https://www.pdcflow.com)

[Powered by PDCflow](https://www.pdcflow.com/) | [Support](https://ticketsupport.pdcflow.com/mytickets?hsLang=en) | [Privacy Policy](https://www.pdcflow.com/privacy-policy/) | [Terms of Use](https://www.pdcflow.com/terms-of-use/)<https://www.pdcflow.com/>

Copyright © 2026, PDCflow