> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Gong Find All References To Email Address: Inputs, Cost &
> Retrieve all references to an email address. Includes inputs, outputs, pricing notes, Deepline CLI examples, and GTM automation guidance.
## Run in Enrichment Spreadsheet
Use this function as a column step in `deepline enrich`.
```bash theme={null}
deepline enrich --input leads.csv --output leads.enriched.csv --with 'result=gong_find_all_references_to_email_address:{"emailAddress":"{{emailAddress}}"}' --json
```
Map payload values to spreadsheet columns with `{{column_name}}` placeholders.
## Input Schema
| Name | Type | Required | Default | Description |
| ---------------------- | -------- | -------- | ------- | ------------------ |
| `payload.emailAddress` | `string` | Yes | | The email address. |
Show raw input schema
### Input JSON Schema
```json theme={null}
{
"type": "object",
"description": "Shows the elements in the Gong system that reference the given email address. Given an emails address, this endpoint returns details of all calls and email messages that reference this address, and any leads or contacts with this email address. When accessed through a Bearer token authorization method, this endpoint requires the scope 'api:data-privacy:read'.",
"properties": {
"emailAddress": {
"type": "string",
"description": "The email address."
}
},
"required": [
"emailAddress"
],
"additionalProperties": false
}
```
## Output Schema
| Name | Type | Required | Default | Description |
| ------------- | -------- | -------- | ------- | ---------------------------------------------- |
| `result.data` | `object` | Yes | | Provider response payload. |
| `result.meta` | `object` | No | | Additional response metadata (status, paging). |
Show raw output schema
### Output JSON Schema
```json theme={null}
{
"type": "object",
"description": "Standard tool result payload.",
"properties": {
"data": {
"type": "object",
"description": "Provider response payload.",
"properties": {
"requestId": {
"type": "string",
"description": "A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes."
},
"emails": {
"type": "array",
"description": "Related email messages.",
"items": {
"type": "object",
"description": "Related email messages.",
"properties": {
"from": {
"type": "string",
"description": "The sender's email address."
},
"id": {
"type": "string",
"description": "Gong's unique 32 character identifier for the email message."
},
"sentTime": {
"type": "string",
"description": "The date and time the email message was sent in the ISO-8601 format, for example: '2024-01-17T16:20:05-03:00' or '2016-02-16T03:57:04.834+05:30' or '2020-11-20T21:30:07.233692Z', where Z stands for UTC."
},
"mailbox": {
"type": "string",
"description": "The mailbox from which the email was retrieved."
},
"messageHash": {
"type": "string",
"description": "Hash code of the email message."
}
},
"additionalProperties": false
}
},
"calls": {
"type": "array",
"description": "Related calls.",
"items": {
"type": "object",
"description": "Details of a call referencing the email address.",
"properties": {
"id": {
"type": "string",
"description": "Gong's unique numeric identifier for the call (up to 20 digits)."
},
"status": {
"type": "string",
"description": "Call status"
},
"externalSystems": {
"type": "array",
"description": "A list of links to external systems such as CRM, Telephony System, Case Management, etc.",
"items": {
"type": "object",
"description": "A list of links to external systems such as CRM, Telephony System, Case Management, etc.",
"properties": {
"system": {
"type": "string",
"description": "External system name.",
"enum": [
"Salesforce",
"HubSpot",
"MicrosoftDynamic",
"Generic"
]
},
"objects": {
"type": "array",
"description": "List of objects within the external system.",
"items": {
"type": "object",
"description": "List of objects within the external system.",
"properties": {
"objectType": {
"type": "string",
"description": "Object Type.",
"enum": [
"Conversation",
"Task"
]
},
"externalId": {
"type": "string",
"description": "External ID."
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}
},
"meetings": {
"type": "array",
"description": "Related meetings.",
"items": {
"type": "object",
"description": "Related meetings.",
"properties": {
"id": {
"type": "string",
"description": "Gong's unique identifier for the meeting."
}
},
"additionalProperties": false
}
},
"customerData": {
"type": "array",
"description": "A list of links to data from external systems (such as CRM, Telephony System, Case Management, etc.) that reference the email address and that Gong stores.",
"items": {
"type": "object",
"description": "A list of links to data from external systems (such as CRM, Telephony System, Case Management, etc.) that reference the email address and that Gong stores.",
"properties": {
"system": {
"type": "string",
"description": "External system name.",
"enum": [
"Salesforce",
"HubSpot",
"MicrosoftDynamic",
"Generic"
]
},
"objects": {
"type": "array",
"description": "List of objects in the external system.",
"items": {
"type": "object",
"description": "List of objects in the external system.",
"properties": {
"id": {
"type": "string",
"description": "Gong's unique numeric identifier (up to 20 digits) for the Lead or Contact."
},
"objectType": {
"type": "string",
"description": "Object Type.",
"enum": [
"Lead",
"Contact"
]
},
"externalId": {
"type": "string",
"description": "External ID."
},
"mirrorId": {
"type": "string",
"description": "Crm Mirror ID."
},
"fields": {
"type": "array",
"description": "Object fields.",
"items": {
"type": "object",
"description": "External object data",
"properties": {
"name": {
"type": "string",
"description": "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."
},
"value": {
"type": "object",
"description": "Field value"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}
},
"customerEngagement": {
"type": "array",
"description": "A list of customer's engagement (such as viewing external share call)",
"items": {
"type": "object",
"description": "A list of customer's engagement (such as viewing external share call)",
"properties": {
"eventType": {
"type": "string",
"description": "Event type",
"enum": [
"contentShared",
"contentViewed",
"customEvent",
"digitalInteraction"
]
},
"timestamp": {
"type": "string",
"description": "The date and time the event occurred in the ISO-8601 format, for example: '2024-01-17T16:20:05-03:00' or '2016-02-16T03:57:04.834+05:30' or '2020-11-20T21:30:07.233692Z', where Z stands for UTC.",
"format": "date-time"
},
"contentId": {
"type": "string",
"description": "Event content id"
},
"contentUrl": {
"type": "string",
"description": "Event content url"
},
"reportingSystem": {
"type": "string",
"description": "Event reporting system"
},
"eventName": {
"type": "string",
"description": "Event name"
},
"sourceEventId": {
"type": "string",
"description": "Source event Id"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"meta": {
"type": "object",
"description": "Additional response metadata (status, paging).",
"additionalProperties": true
}
},
"required": [
"data"
],
"additionalProperties": false
}
```
## Advanced: Direct CLI
Use direct execution for single payload debugging.
```bash theme={null}
deepline tools execute gong_find_all_references_to_email_address --payload '{
"emailAddress": "string"
}' --json
```
### CLI flags
| Flag | Description |
| --------------------------- | --------------------------------------------------- |
| `--json` | Print machine-readable output. |
| `--wait` | Wait for terminal provider status when supported. |
| `--debug` | Enable wait mode with additional status/log output. |
| `--wait-timeout SECONDS` | Max seconds to wait in wait mode. |
| `--poll-interval SECONDS` | Polling interval in seconds during wait mode. |
| `--timeout SECONDS` | Request timeout in seconds. |
| `--connect-timeout SECONDS` | Connection timeout in seconds. |
## Cost
* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.
* Billing mode: `no_bill`.