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.

List assigned flows for the given prospects (/v2/flows/prospects)

  • Updated on Nov 17, 2025
  • Published on Oct 19, 2025
  • 2 minute(s) read
Prev Next
Post
/v2/flows/prospects

Get the Gong Engage flows assigned to the given prospects.

Required authorizaton scope: 'api:flows:read'.

Body parameters
object

Prospects assigned flows request

crmProspectsIds
Array of string Required

The CRM IDs of the prospects to list assigned flows for

Example[ "a5V1Q00A120DP4CVAW" ]
string

The CRM IDs of the prospects to list assigned flows for

Example["a5V1Q00A120DP4CVAW"]
Responses
200

Successful response

Expand All
object
requestId
string

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

Example4al018gzaztcr8nbukw
prospectsAssigned
Array of object (PublicApiAssignedFlow)

The flow instances assigned to the given prospects

object
flowId
string

The Gong Engage Flow ID the prospect was assigned to.

Example1695493301223590792
flowName
string

The Gong Engage Flow name the prospect was assigned to.

ExampleSDR Flow
crmProspectId
string

The CRM ID of the prospect that was assigned to a Gong Engage flow.

Examplea5V1Q00A120DP4CVAW
flowInstanceId
string

The newly created flow instance id.

Example1234361284629356
flowInstanceOwnerEmail
string

The email address of the Gong user who owns the flow instance tasks.

Exampletest@test.com
flowInstanceOwnerFullName
string

The full name of the Gong user who owns the flow instance tasks.

ExampleTest User
flowInstanceCreateDate
string

The creation date of the flow instance 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.

Example2019-01-20T00:00:00-08:00
flowInstanceStatus
string

The status of the flow instance.

Valid values[ "Running", "Pending", "Paused" ]
ExampleRunning
workspaceId
string

The workspace ID this flow belongs to.

Example623457276584334
exclusive
boolean

Indicates whether a prospect in this flow can be added to other flows

Exampletrue
400

Malformed request

object
requestId
string

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

Unauthorized

object
requestId
string

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
403

Forbidden

object
requestId
string

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

Headers
Retry-After
integer
Number of seconds to wait before making a new request.
object
requestId
string

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

object
requestId
string

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