Prefill Shares

||

Use Showpad's sharing URL scheme to launch a pre-populated email or link Share directly from your HTML5 app. Pass query parameters to pre-fill the recipient list, subject line, body text, and attachments.

What you'll learn

• How to construct a Showpad sharing URL
• Which parameters are available and how to format them
• How to combine multiple parameters in a single URL

TL;DR

• Base URL: https://{org}.showpad.biz/webapp2/share
• action is required (email or link); all other parameters are optional
• All parameter values must be URL-encoded
• recipients takes a URL-encoded JSON array

Prerequisites

• Plan: eOS Expert, eOS Advanced, eOS Professional
• Legacy plan: Showpad Content Ultimate
• Permissions: Administrator
• Config:
  • A third-party app to direct users to Showpad from
  • All passed elements must be URL-encoded

Query parameters

Parameter	Data Type	Description
action	String	email or link. Required to trigger the Share; all other parameters are optional.
recipients	Array of JSON objects	Email addresses to receive the email Share. Each object can have: Email (String, required), FirstName (String, optional), LastName (String, optional)
subject	String	Text for the subject line of the email Share.
attachments	Array of slugs	Content added using asset slugs. Include multiple assets using a comma-separated list. The selected content is appended to the end of the email body.
body	String	Text that will appear in the body of the email.

Recipients example

https://myorganization.showpad.biz/webapp2/share?action=email&recipients=%5B%7B%22Email%22%3A%22example%40example.com%22%2C%22FirstName%22%3A%22Joe%22%2C%22LastName%22%3A%22Doe%22%7D%5D

Decoded, the recipients parameter is:

[{ "Email": "example@example.com", "FirstName": "Joe", "LastName": "Doe" }]

Subject example

https://myorganization.showpad.biz/webapp2/share?action=email&subject=my%20happy%20idea

Finding asset slugs

To find asset slugs for the attachments parameter:

1. Navigate to the particular asset in the Files library.
2. Click on the asset to open the details panel.
3. Copy the App Link from the Overview section.

Body example

https://myorganization.showpad.biz/webapp2/share?action=email&body=Hi%20Buyer%2C%0A%0ACheck%20out%20this%20content!

Combined parameters

You can combine multiple parameters in a single URL:

https://myorganization.showpad.biz/webapp2/share?action=email&subject=Follow-up%20from%20our%20meeting&body=Hi%2C%0A%0AHere%20is%20the%20content%20we%20discussed.&attachments=abc123,def456