Skip to content

pdfFiller

The pdfFiller modules enable you to watch events, create, upload, copy, download, list, move, rename and delete documents, or work with signature requests and filled forms in your pdfFiller account.

Getting Started With pdfFiller

Prerequisites

  • A pdfFiller account

In order to use pdfFiller with Ibexa Connect, it is necessary to have a pdfFiller account. If you do not have one, you can create a pdfFiller account at www.pdffiller.com.

Note

The module dialog fields that are displayed in bold (in the Ibexa Connect scenario, not in this documentation article) are mandatory!

Connecting pdfFiller to Ibexa Connect

  1. Go to Ibexa Connect, and open the pdfFiller module's Create a connection dialog.

  2. Enter a name for the connection to the Connection name field, and click Continue.

    61f3a3fd5b584.gif

    After you click the Continue button, Ibexa Connect will redirect you to the pdfFiller website, where you will be prompted to grant Ibexa Connect access to your account.

    61f3a3ff677b8.png

Confirm the dialog by clicking the AUTHORIZE button.

Document

Create a Template From Template

Creates a new template by filling a template. The template containing radio fields is not supported.

Note

Templates containing radio button fields are not supported!

Template ID Select the template from which you want to create the new template.
Folder ID Select the target folder you want to create a new template in.
Document Name Enter the name for the new template.
Fillable Fields Fill in the template's fields. Field names in bold are required.

Creates a public URL that allows you to share the PDF.

Template ID Select the template you want to create the new document from.
Days until Expires Enter the number of days left until the link expires. Max value: 1000.
Custom Logo ID Select or map the Custom Logo for the document.
Redirect URL Enter the URL the user is redirected to after filling up the PDF.
Turn Off Specific Editor Modules Select editor modules you want to turn off in the shared document.

Upload a Document

Uploads a document from the provided URL or file data. Creates a new document template. Supported file types: PPT; PPTX; DOC; DOCX; or PDF.

Upload By Select whether you want to provide a file using a previous module (file) or using the URL.
URL Enter the link to the file that you want to upload to your pdfFiller account. Supported file types: PPT; PPTX; DOC; DOCX; or PDF.
File Name Enter the name of the document as you want to store it.
* Source file * Map the file you want to upload from the previous module (e.g., HTTP > Get a File or Google Drive > Download a File), or enter the file name and file data manually.
Folder ID Select the target folder you want to upload a file to.
With Tags Select the Yes option to render all tags in the document as fillable fields.

Copy a Document

Copies a document to the specified target folder under the desired document name.

Document ID Enter (map) or select the document you want to copy.
New Folder ID Select or map the destination folder to which you want to copy the document.
New Document Name Enter the new name for the document.

Download a Document

Downloads a document.

Folder ID Enter (map) or select the folder that contains the document you want to download.
Document ID Select or map the ID of the document you want to download.

List Documents

Retrieves documents by filter settings.

Folder ID Enter (map) or select the folder you want to list documents from.
Start Date Enter the date to filter documents by from the specified date.
End Date Enter the date to filter documents by up to the specified date.
Order By Select the property you want to sort returned documents by.
Order Select the sort order.
Limit Set the maximum number of documents Ibexa Connect will return during one execution cycle.

Move a Document

Moves a document to the specified target folder.

Document ID Enter (map) or select the document you want to move.
New Folder ID Select or map the destination folder where you want to move the document.

Rename a Document

Renames an existing document.

Document ID Enter (map) or select the document you want to rename.
New Document Name Enter the new name of the document without an extension.

Delete a Document

Deletes a document.

Document ID Enter (map) or select the document you want to delete.

Fill Request

Create a Fill Request

Creates a new document and provides a short URL.

Document ID

Enter (map) or select the document you want to create a fill request for.

Notifications

Select the notification mode. If the notification mode is Enabled or With PDF, you need to specify the Notification Emails.

Sender Notifications

Enable to receive notifications.

Access

Set the access level for the fill request document.

Status

Set the document access permission.

Additional Documents

Specify additional documents required after filling in the document.

Field Wizard

Select one of these options:

  • On: displays fillable fields with wizard.

  • Off: displays fillable fields without wizard.

  • Disabled: disables fillable fields display.

Get a Filled Form

Retrieves filled form details.

Fill Request ID Enter (map) or select the link to fill you want to retrieve details for.
Filled Form ID Enter (map) or select the filled form you want to retrieve details for.

Get a Filled Form Data

Retrieves data from the filled form.

Fill Request ID Enter (map) or select the link to fill you want to retrieve filled data for.
Filled Form ID Enter (map) or select the filled form you want to retrieve filled data for.

Download a Filled Form

Downloads a filled form as PDF.

Fill Request ID Enter (map) or select the link to fill you want to download filled data from.
Filled Form ID Enter (map) or select the filled form you want to download filled data from.
File Name Enter the file name of the downloaded PDF file (without the extension).

Download an Additional Document

Downloads a file of a filled form's additional document.

Fill Request ID Enter (map) or select the link to fill you want to download the additional document from.
Filled Form ID Enter (map) or select the filled form you want to download the additional document from.
Additional Document ID Enter (map) the ID of the additional document you want to download.

Signature Request

Create Signature Request

Creates a new signature request from an existing document.

Document ID

Enter (map) or select the document you want to create a signature for.

Method

Select whether to send to a group or send to each recipient.

  • SendToEach: each recipient signs only his/her copy of the document and returns it to you.

  • SendToGroup: all recipients sign the same document, for instance, a multilateral agreement, and submit it to you.

Security PIN

Set your desired security level.

  • Standard: no PIN is used.

  • Enhanced: specify the PIN in the field below. PIN is not included in the signature request.

PIN

Set the PIN for enhanced security.

Envelope Name

Enter the envelope name when sending the signature request to the group.

Sign In Order

Check to enable the order in which SendToGroup recipients receive their requests to sign the document.

Recipients

Add recipients of the signature request, and specify their details.

Sender Notifications

Enable to receive notifications.

Get a Signature Request

Retrieve request details.

Signature Request ID Enter (map) or select the signature request you want to retrieve details for.

List Signature Requests

Retrieves all signature requests in your account by the filter settings.

Folder ID Enter (map) or select the folder you want to list signature requests from.
Start Date Enter the date to filter signature requests by from the specified date.
End Date Enter the date to filter signature requests by up to the specified date.
Order By Select the property you want to sort returned signature requests by.
Order Select the sort order.
Limit Set the maximum number of signature requests Ibexa Connect will return during one execution cycle.

Cancel a Signature Request

Cancels a specified signature request.

Signature Request ID Enter (map) or select the signature request you want to cancel.

Add Signature Request Recipients

Adds an additional recipient to a signature request, available only for SendToGroup.

Signature Request ID Enter (map) or select the signature request you want to add recipients to.
Recipients Add recipients of the signature request and specify their details.

List Signature Request Recipients

Returns all information about signature recipients and the signature status.

Signature Request ID Enter (map) or select the signature request you want to retrieve recipients for.
Order By Select the property you want to sort returned signature requests by.
Order Select the sort order.
Limit Set the maximum number of signature requests Ibexa Connect will return during one execution cycle.

Send a Signature Request Reminder

Sends a reminder to the signature request recipient.

Signature Request ID Enter (map) or select the signature request you want to send a reminder for.
Recipient Enter (map) or select the recipient you want to send the signature request reminder to.

Other

Watch Events

Triggers when a fill request, signature request, or a template constructor is completed.

Open module settings, and click the Add button to configure the trigger.

61f3a40050de4.png

Webhook name Enter the name for the webhook. E.g., Fill Request Completed
Trigger By Select the type of event that will trigger the Watch Events module, and select the particular document you want to watch in the field below.

Now, every time the specified event occurs, the Watch Events module in your Ibexa Connect scenario is triggered.

Make an API Call

Allows you to perform a custom API call.

URL

Enter a path relative to https://api.pdffiller.com.For example: /v2/users/me.

For the list of available endpoints, refer to the pdfFiller API Reference.

Method

Select the HTTP method you want to use:

GET

to retrieve information for an entry.

POST

to create a new entry.

PUT

to update/replace an existing entry.

PATCH

to make a partial entry update.

DELETE

to delete an entry.

Headers

Enter the desired request headers. You don't have to add authorization headers; we've already added these for you.

Query String

Enter the request query string.

Body

Enter the body content for your API call.

Example of Use - List Folders

The following API call returns all folders in your pdfFiller account:

URL:

/v2/folders

Method:

GET

61f3a4018967c.png

The result can be found in the module's Output under Bundle > Body > items.

In our example, 2 folders were returned:

61f3a40287633.png