Add prospects to an Engage flow

Add prospects to an Engage flow

Assigns up to 100 CRM contacts or leads to a Gong Engage flow, starting its email and call to-dos for them.

Note: Starts real outreach: confirm the flow and the prospects first. Needs Gong Engage; get the flowId from GET /v2/flows, and OAuth apps need the api:flows:write scope.

Set up

Use the first option your agent supports.

API (official)

• Base URL: https://{company}.api.gong.io
• Endpoint: POST /v2/flows/prospects/assign
• Auth: send the header Authorization: Basic $GONG_API_KEY
• Get a key: https://app.gong.io/company/api
• Docs: https://help.gong.io/apidocs/introduction-2

Note: {company} is your API host prefix from Gong's API settings, as in company-17.api.gong.io. GONG_API_KEY holds the base64 of <access key>:<secret>; 3 calls a second, 10,000 a day.

Before anything else, confirm access with the cheapest read-only call, like a list or a search. Never send or change anything to test access.

Rules

• Ask the user before anything that sends messages, costs money, or changes data, and say how many records it touches. One approval covers a batch the user has seen.
• Never print API keys.