Kick-start and prefill email shares or links

Note: This article is no longer maintained. For updated information, please refer to the corresponding Admin App article. We recommend updating your links if you’ve linked to this article.

As a developer, you can structure a Showpad sharing URL so that it can kickstart the Showpad iOS or Web app, and prefill elements of an email share or link share. This tutorial gives you the information you need to kick-start Showpad from other iOS or Web apps and pre-fill an email share for sellers, creating a smooth and productive experience from one app to another. Imagine a sales rep at a tradeshow scans a prospect's business card using your lead capturing scanner on their iPad. Now they can select the "Share Showpad Content" button you've developed, and the Showpad app will be open with an email share, subject line, content, and recipient already filled in. This makes it easy for sellers to do some final edits and send a share at the touch of a button.

You need this to succeed

• All passed elements must be URL encoded
• Administrator access to a Showpad's Online Platform if asset ID's are needed
• Showpad Ultimate Package
• A third-party app you wish to direct users to Showpad from

See how it works 

Subject

Simply write in the subject you wish to include. 

Example:

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

Email Body

Example:

https://myorganization.showpad.biz/webapp2/share?action=email&body=Hi%20Buyer%2C%0A%0Adid%20you%20see%20this%20thing%20here%3A%20%3Capp%2Fasset%2F21ddda8e-5fcc-4ef5-b731-a3da61762baf%22%3EShowpad%20asset%3C%2Fa%3E%0A%0ABut%20also%20%3Cb%3E%3Cu%3Ebold%20underlined%3C%2Fu%3E%3C%2Fb%3E%0A%0AThanks%2C%0ATestUser

Recipient

Add recipients who will receive the email share.

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%2C%7B%22Email%22%3A%22example2%40example.com%22%2C%22FirstName%22%3A%22Jake%22%2C%22LastName%22%3A%22Doe%22%7D%5D

Attachments

Adding content happens using the asset slugs. For multiple assets, use a comma-separated list of slugs. This is also the format that should be used in ShowpadJS. Content will be added to the end of the email body, the same as it appears when selecting content from within the content picker inside an email share.
Asset slugs can be found in the content library. Navigate to the particular asset, then click to open the asset detail panel. In the Info tab, copy the App Link. Read more about locating asset links or slugs here. 

Example:

https://myorganization.showpad.biz/webapp2/share?action=email&attachments=slug1,slug2

The combined parameters

Example

https://myorganization.showpad.biz/webapp2/share?action=email&subject=subject&body=body&attachments=attachments 

URL Length

On iOS URLs can have a length of INT_MAX and are limited to that due to compatibility with 32 bit.

In conclusion

The action parameter is required to trigger the share, but all other elements are optional.

Query parameters are as follows:

• action => String : email or link
• recipients => Array of json objects with following properties: Email: string, FirstName: Optional String, LastName: Optional string 
• subject=> String
• attachments => Array of slugs
• body => String