This plugin provides an API integration for DocSpring. Sign up for a free trial at: https://docspring.com
1. Create an API token in DocSpring.
2. Set your API Token ID and Secret in the DocSpring plugin settings.
3. If you are using the EU region, set the "Region" field to "EU" in the plugin settings. Otherwise, leave this field blank. (It will use the US servers by default.)
4. Create a template in DocSpring. (Setting all field types to "text" may help you avoid any unnecessary errors.)
5. Enable "Allow Additional Properties in JSON Data" in your template's Settings.
6. Use the "DocSpring - Create PDF Submission" action in Workflows > Plugins to generate a PDF.
7. The "PDF File" property will be available as a "Result of Step X" property. This is the download URL of the file.

"PDF File" is a *temporary* URL that is only valid for 60 minutes. Please make sure that you use Bubble's ":saved to S3" option so that Bubble will download the PDF and store it (see our demo app for an example.) If you don't use "PDF File:saved to S3", then you won't be able to access your PDF after 60 minutes.

- You can change the name of the PDF file by setting the "pdf_filename" key under the metadata option. (You don't need to include .pdf at the end.) See our API documentation for more information: https://docspring.com/docs/api/generate_pdf.html


Plugin Settings (Dev vs Deployed)
------------------------------------------------
When configuring the DocSpring plugin in your app, you will see "Token ID", "Token Secret", and "Region" fields. There are also the same three fields with a "- dev." suffix. The "dev" fields are a Bubble feature that allow you to use different settings while developing/testing your app vs. the live deployed version.

These "dev" fields are not related to DocSpring's concept of test/live PDFs, but typically you would set a test API token in the "dev" fields and a live API token in the non-dev fields.

Sending Images
------------------------------------

If your PDF template has an image field, you can send an image as a URL or a base64-encoded string. You will need to append "/url" or "/base64" to the image field's name when you are setting up your Create PDF Submission call.

For example, if you have an image field named "image" and you want to use an image from a URL, you can use "image/url" as the key for your Data, and enter a URL in the value field.


Feedback
------------------------------------

Please let us know about any bugs and issues at: [email protected]