Skip to main content

Sharing Themes

Sharing Themes enable you to create a consistently branded, and visually appealing experience for content sharing. They ensure that all of your shared content reflects a consistent brand image.

With Sharing Themes, you can specify:

  • Branding: Logos, brand colors, fonts, and other design elements that align with your company's identity.

  • Layout and Presentation: Defines how files, videos, links, or presentations appear in the shared view.

  • Recipient Experience: When content is shared, recipients interact with it via a webpage styled using the Sharing Theme.

Prequisites
  • Plan: Ultimate | Advanced or Expert
  • Permissions: Administrator access to Showpad's Admin App

Base Endpoint

The base endpoint for Shared Space management calls is:

https://{{subdomain}}.api.showpad.com/v4

Every API v4 request needs to be prefixed with the base endpoint.

Single Sharing Theme

MethodEndpointDescription
GET/themes/{themeId}Returns a single Shared Space Theme (specified by {themeId}).

Example

curl -X 'GET' \
'https://{{subdomain}}.api.showpad.com/v4/themes/51be10f001cd0303a4e308a22e051ecbcb1a5b0ba9ae9e5bb38167ed0c5b3a09 \
-H 'accept: application/json'

Response

{
"id": "51be10f001cd0303a4e308a22e051ecbcb1a5b0ba9ae9e5bb38167ed0c5b3a09",
"title": "Global Theme",
"isGlobal": true,
"isDefault": false,
"displayData": {
"aboutDescription": "doc.",
"logo": {
"url": "https://{{subdomain}}.showpad.com/catalog/setting/3/downloadLogo?hash=45c48cce2e2d7fbdea1afc51c7c6ad26"
},
"displayImage": {
"url": "https://{{subdomain}}.showpad.com/catalog/setting/3/downloadPromo?hash=d4c2e4a3297fe25a71d030b67eb83bfc"
}
},
"colorSettings": {
"headerColor": "426e7c",
"headerFontColor": "F6F6F6",
"accentColor": "216073",
"accentFontColor": "F6F6F6"
},
"createdAt": "2020-02-10T11:09:05.000Z",
"updatedAt": "2024-08-28T15:10:22.000Z",
"division": null
}

List of Sharing Themes

MethodEndpointDescription
GET/themesReturns a list of all Shared Space Themes.

Example

curl -X 'GET' \
'https://{{subdomain}}.api.showpad.com/v4/themes \
-H 'accept: application/json'

Response

{
"count": 2,
"items": [
{
"id": "51be10f001cd0303a4e308a22e051ecb5385615a564eeef116fec329acb33276",
"title": "Growth Gold",
"isGlobal": false,
"isDefault": true,
"displayData": {
"aboutDescription": "",
"logo": {
"url": "https://{{subdomain}}.showpad.com/catalog/setting/4/downloadLogo?hash=33e75ff09dd601bbe69f351039152189"
},
"displayImage": null
},
"colorSettings": {
"headerColor": "666666",
"headerFontColor": "F6F6F6",
"accentColor": "666666",
"accentFontColor": "F6F6F6"
},
"createdAt": "2020-02-17T11:24:37.000Z",
"updatedAt": "2025-01-09T11:27:22.000Z",
"division": {
"id": "26092c300714ba38ecc245b0da65daef"
}
},
{
"id": "51be10f001cd0303a4e308a22e051ecbcb1a5b0ba9ae9e5bb38167ed0c5b3a09",
"title": "Global Theme",
"isGlobal": true,
"isDefault": false,
"displayData": {
"aboutDescription": "Marketing & Revenue",
"logo": {
"url": "https://{{subdomain}}.showpad.com/catalog/setting/3/downloadLogo?hash=45c48cce2e2d7fbdea1afc51c7c6ad26"
},
"displayImage": {
"url": "https://{{subdomain}}.showpad.com/catalog/setting/3/downloadPromo?hash=d4c2e4a3297fe25a71d030b67eb83bfc"
}
},
"colorSettings": {
"headerColor": "426e7c",
"headerFontColor": "F6F6F6",
"accentColor": "216073",
"accentFontColor": "F6F6F6"
},
"createdAt": "2020-02-10T11:09:05.000Z",
"updatedAt": "2024-08-28T15:10:22.000Z",
"division": null
}
]
}