CRM Log History
Retrieve CRM records linked to Showpad activities. When users log Shared Space or Share activities to their CRM, you can fetch the associated CRM records (accounts, contacts, opportunities, leads) for reporting or custom integrations.
What you'll learn
- How to retrieve CRM records for a Shared Space
- How to retrieve CRM records for a Share
TL;DR
- Shared Space records? Use
GET /crm/shared-space-records/{sharedSpaceId} - Share records? Use
GET /crm/share-records/{shareId}
When to use the API
| Custom Reporting | Showpad Apps | Data Sync |
|---|---|---|
| Pull CRM data into custom dashboards or reports. | Display CRM context within Showpad Apps. | Keep external systems updated with CRM associations. |
Prerequisites
- Plan: Ultimate | Advanced or Expert
- Permissions: Administrator access to Showpad's Admin App
- Authentication: Valid OAuth 2.0 access token (learn more)
- Config: A CRM instance integrated with Showpad
Base Endpoint
https://{{subdomain}}.api.showpad.com/v4
Shared Space Records
Retrieve CRM records associated with a Shared Space:
| Method | Endpoint | Description |
|---|---|---|
GET | /crm/shared-space-records/{sharedSpaceId} | Returns a list of CRM records that are associated with a Shared Space identifier. |
Example
- cURL
- JavaScript
- Python
curl "https://{{subdomain}}.api.showpad.com/v4/crm/shared-space-records/1478963215987532" \
-H "Authorization: Bearer {access_token}"
const response = await fetch('https://{{subdomain}}.api.showpad.com/v4/crm/shared-space-records/1478963215987532', {
headers: { Authorization: 'Bearer {access_token}' },
});
const records = await response.json();
import requests
response = requests.get(
'https://{{subdomain}}.api.showpad.com/v4/crm/shared-space-records/1478963215987532',
headers={'Authorization': 'Bearer {access_token}'}
)
records = response.json()
Example Response
[
{
"type": "Account",
"id": "0015f000003rb46AAA",
"name": "Point",
"url": "https://customer-org.my.salesforce.com/0015f000003rb46AAA"
},
{
"type": "Opportunity",
"id": "0065f000002wrs4AAA",
"name": "Point SLA",
"url": "https://customer-org.my.salesforce.com/0065f000002wrs4AAA",
"accountId": "0015f000003rb46AAA"
},
{
"type": "Contact",
"id": "0035f0000034KVdAAM",
"name": "Edna Ipsum",
"url": "https://customer-org.my.salesforce.com/0035f0000034KVdAAM",
"accountId": "0015f000003rb46AAA"
}
]
tip
Get the Shared Space ID from webhook payloads or the Shared Spaces API.
Share Records
Retrieve CRM records associated with a Share:
| Method | Endpoint | Description |
|---|---|---|
GET | /crm/share-records/{shareId} | Returns a list of CRM records that are associated with a Share identifier. |
Example
- cURL
- JavaScript
- Python
curl "https://{{subdomain}}.api.showpad.com/v4/crm/share-records/12356897654" \
-H "Authorization: Bearer {access_token}"
const response = await fetch('https://{{subdomain}}.api.showpad.com/v4/crm/share-records/12356897654', {
headers: { Authorization: 'Bearer {access_token}' },
});
const records = await response.json();
import requests
response = requests.get(
'https://{{subdomain}}.api.showpad.com/v4/crm/share-records/12356897654',
headers={'Authorization': 'Bearer {access_token}'}
)
records = response.json()
Example Response
[
{
"type": "Account",
"id": "0015f000003rb46AAA",
"name": "Point",
"url": "https://customer-org.my.salesforce.com/0015f000003rb46AAA"
},
{
"type": "Contact",
"id": "0035f000002hHKiAAM",
"name": "Paul Ipsum",
"url": "https://customer-org.my.salesforce.com/0035f000002hHKiAAM",
"accountId": "0015f000003rb46AAA"
}
]
tip
Get the Share ID from webhook payloads or the Shares API.
Next steps
- CRM Integration Overview - Configure your CRM connection with Showpad
- Webhooks - Subscribe to Share and Shared Space events
Was this page helpful?