---
title: "Report event of a content share"
slug: "report-event-of-a-content-share-v2customer-engagementcontentshared"
updated: 2025-11-17T08:10:53Z
published: 2025-11-17T08:12:09Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.gong.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Report event of a content share (/v2/customer-engagement/content/shared)

Put/v2/customer-engagement/content/shared

Push engagement events into Gong and display them as events in Gong’s activity timeline, when a Gong user shares content with external participants (for example, a contract was “shared” by the account executive with his prospects)

Required authorizaton scope: 'api:engagement-data:write'.

Body parameters<select class='api-response-data' aria-label='Media type'><option value='d33b164d-addd-4cf5-a76e-f6b27083d6e5'>application/json</option>
</select>Expand Allobject  

Content Shared Event

reportingSystemstring    Required

The unique identifier of the reporting system. It is the same value in all events originating from the same system.

Exampleabc123
eventTimestampstring    Required

The date and time when the event happened in the ISO-8601 format (e.g., '2021-08-01T02:30:00+05:00' or '2021-08-01T08:00:00Z', where Z stands for UTC);

Example2021-02-17T02:30:00-08:00
eventIdstring    

The original id of the event as designated in the reporting system.

Exampleabc123
contentIdstring    Required

The id of the content that was shared in the reporting system.

Exampledoc_123456789
contentUrlstring    Required

The url of the content that was shared in the reporting system. This is the url that is was accessed by the viewer.

Examplehttps://example.com/doc_123456789
contentTitlestring    Required

Human readable title of the content.

ExampleFeatures & Spec V.1
shareIdstring    

The id of the share action, in case there can be more than one share per content.

Exampleabc123
shareInfoUrlstring    

The link to a page that presents additional information about this event.

Examplehttps://example.com/path/to/a/page
sharingMessageSubjectstring    

The subject of share email / message.

ExampleSample Subject
sharingMessageBodystring    

The share message body. Can contain HTML and will be cleaned when it is presented.

Example<b>Hi</b>
sharerobject (Sharer)  idstring    

The user id in Gong, if available.

Example234599484848423
emailstring    

The email address of the person, if available.

Exampletest@test.com
namestring    

The name of the person, if available.

ExampleTest User

recipients Array of object (Actor)   

array of objects with name + email of recipients. Email is required.

object  emailstring    

The email address of the person, if available.

Exampletest@test.com
namestring    

The name of the person, if available.

ExampleTest User
titlestring    

The title of the person, if available.

ExampleEnterprise Account Executive
context Array of object (PartyUploadContext)   

A list of links to external systems such as CRM, Telephony System, Case Management, etc.

object  

Links to external systems such as CRM, Telephony System, Case Management etc. Currently only Salesforce and Generic are supported.

systemstring    Required

External system name. Currently only Salesforce and Generic are supported.

Valid values[
  "Salesforce",
  "HubSpot",
  "MicrosoftDynamic",
  "Generic"
]ExampleSalesforce
objects Array of object (ExternalCrmPartyObject)   

List of objects within the external system

object  

External object associated with the party

objectTypestring    Required

Object Type. Valid only for non-company parties. e.g. Lead.

Valid values[
  "Lead",
  "Contact",
  "Account",
  "Opportunity",
  "User",
  "Lead,Contact"
]ExampleContact
objectIdstring    Required

Object ID. For Salesforce both case-sensitive and case-insensitive formats are supported.

Example0013601230sV7grAAC
fields Array of object (CrmPartyContextField)   

Object fields. Intended for future use only.

object  

External object data

namestring    

Field name

Examplename
valueobject  

Object value

ExampleGong Inc.

crmContext Array of object (CallUploadContext)   

A list of references to external systems such as CRM, Telephony System, Case Management, etc.

object  

Links to external systems such as CRM, Telephony System, Case Management etc. Currently only Salesforce and Generic are supported.

systemstring    Required

External system name. Currently only Salesforce and Generic are supported.

Valid values[
  "Salesforce",
  "HubSpot",
  "MicrosoftDynamic",
  "Generic"
]ExampleSalesforce
objects Array of object (ExternalCrmCallObject)   

List of objects within the external system. Note: Multiple opportunities/deals belonging to the same account are not supported.

object  

External object associated with the call

objectTypestring    Required

Object Type. e.g. Account.

Valid values[
  "Opportunity",
  "Account",
  "Lead",
  "Contact",
  "User",
  "Opportunity,Account"
]ExampleAccount
objectIdstring    Required

Object ID. For Salesforce both case-sensitive and case-insensitive formats are supported.

Example0013601230sV7grAAC
fields Array of object (ContextField)   

Object fields. Intended for future use only.

object  

External object data

namestring    

Field name. For Account supported fields are: Name, Website, Industry and all the custom fields. For Opportunity supported fields are Name, LeadSource, Type, StageName, Probability, Amount, CloseDate and all the custom fields.

Examplename
valueobject  

Field value

ExampleGong Inc.

contentProperties Array of object (Generic Property)   

A list of additional properties for the content

object  

A list of additional properties for the event

namestring    Required

Property name.

valuestring    Required

Property value. Value format should match dataType. If dataType is "number", value should be passed in JSON number format, e.g. 3.14. If dataType is "date", the value should be passed in JSON date format, e.g. 2021-02-17T02:30:00-08:00. If the dataType is "url", the value should be valid URL, e.g. "https://example.com/example?q=v"

Examplestring
dataTypestring    Required

Property data type.

Valid values[
  "number, string, url, date"
]Examplestring

eventProperties Array of object (Generic Property)   

A list of additional properties for the event

object  

A list of additional properties for the event

namestring    Required

Property name.

valuestring    Required

Property value. Value format should match dataType. If dataType is "number", value should be passed in JSON number format, e.g. 3.14. If dataType is "date", the value should be passed in JSON date format, e.g. 2021-02-17T02:30:00-08:00. If the dataType is "url", the value should be valid URL, e.g. "https://example.com/example?q=v"

Examplestring
dataTypestring    Required

Property data type.

Valid values[
  "number, string, url, date"
]Examplestring

workspaceIdstring    

Optional workspace identifier. If specified, the event will be placed into this workspace, otherwise, the default algorithm for workspace placement will be applied.

Example623457276584334
actionNamestring    

The name of the action like "Document Sent" or "Presentation Shared".

ExampleMy Title
nonCompanyParticipants Array of object (Actor)   object  emailstring    

The email address of the person, if available.

Exampletest@test.com
namestring    

The name of the person, if available.

ExampleTest User
titlestring    

The title of the person, if available.

ExampleEnterprise Account Executive
context Array of object (PartyUploadContext)   

A list of links to external systems such as CRM, Telephony System, Case Management, etc.

object  

Links to external systems such as CRM, Telephony System, Case Management etc. Currently only Salesforce and Generic are supported.

systemstring    Required

External system name. Currently only Salesforce and Generic are supported.

Valid values[
  "Salesforce",
  "HubSpot",
  "MicrosoftDynamic",
  "Generic"
]ExampleSalesforce
objects Array of object (ExternalCrmPartyObject)   

List of objects within the external system

object  

External object associated with the party

objectTypestring    Required

Object Type. Valid only for non-company parties. e.g. Lead.

Valid values[
  "Lead",
  "Contact",
  "Account",
  "Opportunity",
  "User",
  "Lead,Contact"
]ExampleContact
objectIdstring    Required

Object ID. For Salesforce both case-sensitive and case-insensitive formats are supported.

Example0013601230sV7grAAC
fields Array of object (CrmPartyContextField)   

Object fields. Intended for future use only.

object  

External object data

namestring    

Field name

Examplename
valueobject  

Object value

ExampleGong Inc.

moreInfoUrlstring    
trackingIdstring    
userAgentstring    
mobileAppIdstring    
agentPlatformstring    

Responses200

Successful response

<select class='api-response-data' aria-label='Media type'><option value='df7108f7-9953-471d-bf3c-debdd43facf0'>*/*</option>
</select>object  requestIdstring    

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
integrationIdinteger  (int64)    <style>.public-api-info {    background: rgb(222, 235, 255);}.public-api-tip {    background: rgb(227, 252, 239);}.public-api-parameter {    background: rgba(9,30,66,0.08);}.public-api-note {    background: rgb(234, 230, 255);}.public-api-important {    background: rgb(255, 250, 230);}.public-api-critical {    background: rgb(255, 235, 230);}table, th, td {  border: 1px solid gray;  border-collapse: collapse;}th, td {  padding: 5px;}th {  text-align: left;}img {  border: 2px solid #D3D5D9;}</style>Your integration ID to be used in requests to the API. This ensures you are accessing the correct integration.  
**Note:** Parse the integrationId as Long or BigInt. Parsing the integrationId as an Integer will truncate the integrationId to trailing zeros and will return an incorrect ID.
Example5517027188234206000

400

Malformed request

<select class='api-response-data' aria-label='Media type'><option value='957550dd-584c-494c-ac77-5d2816503edd'>*/*</option>
</select>object  requestIdstring    

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
errors Array of string   

Error messages.

Example[
  "An error has occurred"
]string    

401

Access denied

<select class='api-response-data' aria-label='Media type'><option value='550d61f8-a0e9-47ea-9a9d-a7e7b8f248e7'>*/*</option>
</select>object  requestIdstring    

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
errors Array of string   

Error messages.

Example[
  "An error has occurred"
]string    

409

Conflict - Event was already reported in the past.

<select class='api-response-data' aria-label='Media type'><option value='9d07345f-3e85-43c3-ba54-2f386b4be623'>*/*</option>
</select>object  requestIdstring    

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
errors Array of string   

Error messages.

Example[
  "An error has occurred"
]string    

429

API request limit exceeded

HeadersRetry-AfterintegerNumber of seconds to wait before making a new request.
<select class='api-response-data' aria-label='Media type'><option value='f30bafcb-75d2-4517-bdc6-e74c56ed50f0'>*/*</option>
</select>object  requestIdstring    

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
errors Array of string   

Error messages.

Example[
  "An error has occurred"
]string    

500

Failed to complete the operation due to an unexpected error

<select class='api-response-data' aria-label='Media type'><option value='ea75703e-3c9a-414f-b6c5-df38bef90527'>*/*</option>
</select>object  requestIdstring    

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
errors Array of string   

Error messages.

Example[
  "An error has occurred"
]string