PDFco (Preview)

PDF.co connector is an excellent tool for converting raw HTML or website URL to PDF document. It also has features to merge documents of different formats into PDF, Split PDF document, adding text/images to existing PDF and filling out PDF form fields.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name PDF.co Support
URL https://support.bytescout.com
Email plugins@bytescout.com
Connector Metadata
Publisher PDF.co
Website https://pdf.co/
Privacy policy https://pdf.co/pages/legal/privacy
Categories Productivity;Data

PDF.co connector provides operations for Merge PDF, Split PDF, HTML to PDF, URL to PDF and modifying PDF. Merge PDF supports merging different types of documents to PDF format. For modifying PDF, it supports adding text/images to PDF and also filling out PDF forms.

Prerequisites

PDF.co requires API Key for authentication of its requests.

How to get credentials

PDF.co API key can be obtained by signing-up with PDF.co.

  • Login to your PDF.co account at https://app.pdf.co
  • After login API Key can be found at "View Your API Key" section.

Get started with your connector

PDF.co connector consists of following actions.

  • HTML to PDF

    HTML to PDF action converts raw HTML to PDF format. Apart from that we can also configure advanced options such as output paper size, orientation of PDF page, margins, custom header and footer, etc.

  • URL to PDF

    As the name suggests, URL to PDF action converts website URL to PDF document. We can configure advanced settings for output page margins, orientation, header and footer, etc.

  • Split PDF

    This action is to split input PDF into multiple pages. We need to specify the “Pages” parameter for how many output pages are required.

  • Merge PDF

    This action merges documents to a PDF file. Here, documents can be of different formats such as pdf, doc, text, excel, zip, etc. Input parameter “URL” requires comma separated document URLs.

  • PDF Filler

    PDF Filler action modifies existing PDF document. With use of this action, we can add Text/Images to existing PDF as well fill PDF forms fields. We have to pass values in a specific format. For more information please visit pdf.co official documentation.

Known issues and limitations

In this initial version of PDF.co connector, only few PDF.co features are covered. One of the features missing in this initial version, is to check async job status and get completed job results.

Common errors and remedies

  • Input URL passed to PDF.co Action must be a valid and publicly accessible URL.

  • If PDF.co request returns 401 - unauthorized result, make sure you have provided valid PDF.co API key.

  • All requests deduct your PDF.co credits based on request processing. Hence, if your PDF.co account does not have enough credits, it’ll result in error.

FAQ

Please refer to PDF.co Knowledgebase for all QAs.

Creating a connection

The connector supports the following authentication types:

Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
API Key securestring The API KEY for this Endpoint True

Throttling Limits

Name Calls Renewal Period
API calls per connection10060 seconds

Actions

HTML to PDF

Convert HTML code snippet into full featured PDF.

Merge PDF

Merge multiple documents into one new single PDF. Supports many file formats. For example, pdf, doc, docx, xls, jpg, png, etc.

PDF Filler

Add text, images, signatures to pdf. Fill PDF form fields and create new pdf from templates

Split PDF

Splits pages from PDF document into multiple new PDF files using page numbers and page ranges

URL to PDF

Create PDF from URL

HTML to PDF

Convert HTML code snippet into full featured PDF.

Parameters

Name Key Required Type Description
HTML
html True html

Input HTML code to be converted.

Name
name string

Base file name for new PDF files.

margins
margins string

Override default margins with custom values (the order is top right bottom left). You can als set all margins: 10px, 5mm, 5in for all sides.

Paper Size
paperSize string

Select PDF paper size. Can be Letter, Legal, Tabloid, Ledger, A0, A1, A2, A3, A4, A5, A6 or a custom size. Custom size can be set in px (pixels), mm or in (inches) with width and height separated by space like this: 200 300, 200px 300px, 200mm 300mm, 20cm 30cm or 6in 8in.

Orientation
orientation string

PDF page orientation.

Print Background
printBackground boolean

Enable or disable printing of document background

Header
header html

Set to HTML for header to be applied on every page at the header.

Footer
footer html

Set to HTML for footer to be applied on every page at the bottom.

Async
async boolean

Set to true to run as async job in background

Returns

Name Path Type Description
URL
url string

Output document URL.

Page Count
pageCount integer

Number of pages in the output document.

Error
error boolean

Indicates whether the operation is successful or not.

Status Code
status integer

Status code for HTTP response

Name
name string

Output document name

Credits
credits integer

PDF.co credits used for this request

Duration
duration integer

Request execution duration

Remaining Credits
remainingCredits integer

PDF.co account remaining credits

Merge PDF

Merge multiple documents into one new single PDF. Supports many file formats. For example, pdf, doc, docx, xls, jpg, png, etc.

Parameters

Name Key Required Type Description
URL
url True string

The comma-separated list of links to PDFs, documents, spreadsheets, images. Enable Auto-convert option to support non-PDF files. Supports links to external sites, filetoken://.. from PDF.co Files storage and links to G Drive, Dropbox and other services. Links should be accessible without password. For password protected PDF files, use PDF Security module first to unlock input pdf.

Async
async boolean

Creates a background processing job.

Returns

Name Path Type Description
URL
url string

Output document URL.

Page Count
pageCount integer

Number of pages in the output document.

Error
error boolean

Indicates whether the operation is successful or not.

Status Code
status integer

Status code for HTTP response

Name
name string

Output document name

Credits
credits integer

PDF.co credits used for this request

Duration
duration integer

Request execution duration

Remaining Credits
remainingCredits integer

PDF.co account remaining credits

PDF Filler

Add text, images, signatures to pdf. Fill PDF form fields and create new pdf from templates

Parameters

Name Key Required Type Description
Async
async boolean

Creates a background processing job.

Name
name string

Output PDF Name

URL
url True string

Url to the input PDF document

Annotations String
annotationsString string

Annotation strings to be added to the PDF document. Format should be like “x;y;page;text”. Refer to PDF.co documentations for more advanced formats and examples.

Images String
imagesString string

Images to be added to the PDF document. Format should be like “x;y;page;urltoimage;link;width;height”. Refer to PDF.co documentations for more advanced formats and examples.

Fields String
fieldsString string

Fill PDF form fields. Format should be like “page;fieldName;value”. Refer to PDF.co documentations for more advanced formats and examples.

Returns

Name Path Type Description
URL
url string

Output document URL.

Page Count
pageCount integer

Number of pages in the output document.

Error
error boolean

Indicates whether the operation is successful or not.

Status Code
status integer

Status code for HTTP response

Name
name string

Output document name

Credits
credits integer

PDF.co credits used for this request

Duration
duration integer

Request execution duration

Remaining Credits
remainingCredits integer

PDF.co account remaining credits

Split PDF

Splits pages from PDF document into multiple new PDF files using page numbers and page ranges

Parameters

Name Key Required Type Description
URL
url True string

Url to the source PDF document

Pages
pages True string

Comma-separated list of page indices (or ranges) to split into. First page is 1 (one). Example: "1,2-5,7-". Special cases: to extract each page into separate PDF use to *.

Name
name string

Base file name for new PDF files

Async
async boolean

Creates a background processing job.

Returns

Name Path Type Description
urls
urls array of string

urls

Page Count
pageCount integer

Number of pages in the output document.

Error
error boolean

Indicates whether the operation is successful or not.

Status
status integer

Status code for HTTP response

Name
name string

Output document name

Credits
credits integer

PDF.co credits used for this request

Duration
duration integer

Request execution duration

Remaining Credits
remainingCredits integer

PDF.co account remaining credits

URL to PDF

Create PDF from URL

Parameters

Name Key Required Type Description
URL
url True string

Link to input HTML file or website page to be converted. You can pass link to file from Google Drive, Dropbox or another online file service that can generate shareable links.

Margins
margins string

Margins to be used in output document. Set to css style margins like 10px, 5mm, 5in for all sides or 5px 5px 5px 5px (the order of margins is top, right, bottom, left).

Paper Size
paperSize string

Letter is set by default. Can be Letter, Legal, Tabloid, Ledger, A0, A1, A2, A3, A4, A5, A6 or a custom size. Custom size can be set in px (pixels), mm or in (inches) with width and height separated by space like this: 200 300, 200px 300px, 200mm 300mm, 20cm 30cm or 6in 8in.

Orientation
orientation string

Output page orientation

Print Background
printBackground boolean

Enable or disable printing of document background

Header
header html

Set to HTML for header to be applied on every page at the header.

Footer
footer html

Set to HTML for footer to be applied on every page at the bottom.

Async
async boolean

Creates a background processing job.

Profiles
CustomScript string

Pass options for advanced output processing.

Returns

Name Path Type Description
URL
url string

Output document URL.

Page Count
pageCount integer

Number of pages in the output document.

Error
error boolean

Indicates whether the operation is successful or not.

Status Code
status integer

Status code for HTTP response

Name
name string

Output document name

Credits
credits integer

PDF.co credits used for this request

Duration
duration integer

Request execution duration

Remaining Credits
remainingCredits integer

PDF.co account remaining credits