View as Markdown
Gong icon

Gong ACTION

Add New Call

Create a call record in Gong and return its ID. Set Download Media URL so Gong can fetch and process the recording; without it the call stays pending and other Gong actions cannot return it. See the documentation
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Gong account once, then configure and run Add New Call from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "gong-add-new-call",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    gong: { authProvisionId: "apn_xxxxxxx" },
    clientUniqueId: "Client Unique ID",
    actualStart: "Actual Start",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Add New Call inputs
Property Type Description
clientUniqueId Client Unique ID string
A call's unique identifier in the PBX or the recording system. Gong uses this identifier to prevent repeated attempts to upload the same recording.
Required
actualStart Actual Start string
The actual date and time when the call started in the ISO-8601 format (e.g., 2018-02-18T02:30:00-07:00 or 2018-02-18T08:00:00Z, where Z stands for UTC).
Required
direction Direction string
Whether the call is inbound (someone called the company), outbound (a rep dialed someone outside the company), or a conference call.
Required
primaryUser Primary User string
The Gong internal user ID of the team member who hosted the call.
Required Dynamic
parties Parties string[]
A list of the call's participants, each a JSON object, e.g. { "name": "Name", "emailAddress": "email@example.com", "phoneNumber": "123123", "mediaChannelId": 1 }. Set userId on the one party who is the internal Gong user hosting the call, e.g. { "name": "Rep Name", "userId": "123456789" }; leave it off everyone else so external attendees are not recorded as employees. If no party sets userId, the Primary User is attached to the first party, since Gong requires a party for the primary user. Always quote userId as a string: Gong IDs run to 20 digits, and an unquoted JSON number above 2^53 loses precision (4011503062935085673 parses as 4011503062935085600).
Required
title Title string
The title of the call. This title is available in the Gong system for indexing and search.
Optional
purpose Purpose string
The purpose of the call. This optional field is a free text of up to 255 characters.
Optional
scheduledStart Scheduled Start string
The date and time the call was scheduled to begin in the ISO-8601 format (e.g., 2018-02-18T02:30:00-07:00 or 2018-02-18T08:00:00Z, where Z stands for UTC);
Optional
scheduledEnd Scheduled End string
The date and time the call was scheduled to end in the ISO-8601 format (e.g., 2018-02-18T02:30:00-07:00 or 2018-02-18T08:00:00Z, where Z stands for UTC);
Optional
duration Duration integer
The actual call duration in seconds.
Optional
disposition Disposition string
The disposition of the call. The disposition is free text of up to 255 characters.
Optional
meetingUrl Meeting URL string
The URL of the conference call by which users join the meeting
Optional
callProviderCode Call Provider Code string
The code identifies the provider conferencing or telephony system. For example: zoom, clearslide, gotomeeting, ringcentral, outreach, insidesales, etc. These values are predefined by Gong, please contact help@gong.io to find the proper value for your system.
Optional
downloadMediaUrl Download Media URL string
The URL from which Gong can download the media file. The URL must be unique, the audio or video file must be a maximum of 1.5GB.
Optional
workspaceId Workspace ID string
Optional workspace identifier. If specified, the call will be placed into this workspace, otherwise, the default algorithm for workspace placement will be applied.
Optional Dynamic
languageCode Language Code string
The language code the call should be transcribed to. This field is optional as Gong automatically detects the language spoken in the call and transcribes it accordingly. Set this field only if you are sure of the language the call is in.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
gong-add-new-call
Version
0.0.7
App
Gong
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes