Add Call
gong.add_call
ActionCRM & salesconnection required
Calls the Gong API with the connection's credentials.
Register a call recorded outside Gong so Gong can ingest its media.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- Username & password
- Providers
- Gong
- Secret shape
- {"username": "<access key>", "password": "<access key secret>"} — the access_key / access_key_secret spelling is accepted too
- Config it needs
- base_url, workspace_id
- Resolved by
- config.connection_id, else node.connection_id
Configuration
18 fields, 5 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
client_unique_id The call's unique id in your recording system. Gong uses it to refuse a duplicate upload of the same recording. | string | Yes | — | — | — |
actual_start When the call actually started, ISO-8601 (e.g. 2026-01-14T09:00:00Z). | string | Yes | — | iso8601 format | 2026-01-14T09:00:00Z |
direction Inbound (someone called in), Outbound (a rep dialled out), Conference, or Unknown. | string | Yes | — | one of "Inbound", "Outbound", "Conference", "Unknown" | — |
primary_user The Gong user id of the team member who hosted the call. | string | Yes | — | — | — |
parties The participants, as a JSON array. Each entry may carry name, emailAddress, phoneNumber, userId and partyId; one must be the host. | array | Yes | — | ≥ 1 characters; array of object | — |
title The call title Gong indexes and searches. | string | No | — | — | — |
purpose Free text describing the purpose of the call (up to 255 characters). | string | No | — | ≤ 255 characters | — |
scheduled_start When the call was scheduled to begin, ISO-8601. | string | No | — | iso8601 format | — |
scheduled_end When the call was scheduled to end, ISO-8601. | string | No | — | iso8601 format | — |
duration The actual call duration in seconds. | number | No | — | ≥ 0 | — |
download_media_url A unique URL Gong can download the recording from (audio or video, at most 1.5 GB). Leave blank to register metadata only. | string | No | — | url format | — |
meeting_url The web-conference URL participants joined the meeting through. | string | No | — | url format | — |
call_provider_code Gong's code for the conferencing or telephony system (zoom, gotomeeting, ringcentral, …). Gong assigns these; ask Gong support. | string | No | — | — | — |
language_code Force the transcription language (e.g. en-US). Leave blank to let Gong detect it. | string | No | — | — | — |
disposition The call disposition, free text of up to 255 characters. | string | No | — | ≤ 255 characters | — |
custom_data Free-text metadata Gong stores with the call for troubleshooting. | string | No | — | — | — |
context CRM context, as a JSON array of {system, objects} entries. system is Salesforce, HubSpot, MicrosoftDynamic or Generic. | array | No | — | array of object | — |
workspace_id Place the call in this workspace. Blank uses the connection's workspace_id, or Gong's own placement rules. | string | No | — | — | — |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"actual_start": "2026-01-14T09:00:00Z"
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
call_id The id Gong assigned to the new call. | string | — |
accepted True when Gong accepted the metadata and returned a call id. | boolean | — |
media_pending True when a download_media_url was supplied: Gong fetches, transcribes and indexes the recording after this node returns, so the call is not searchable yet. | boolean | — |
request_id Gong's reference id for this request. | string | — |
{
"accepted": false,
"call_id": "",
"media_pending": false,
"request_id": ""
}Notes
- Gong refuses a second upload with the same client_unique_id, which is what makes a retry safe.
See Add Call run in a workflow.
In a technical demo we add the Gong connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.