---
ref: tool:gong/assign-prospects-to-flow
name: Add prospects to an Engage flow
company: company:gong
workflows: []
access: [api]
tags: [capability:enroll-in-sequence, category:revenue-intelligence, has:api]
docs: https://help.gong.io/apidocs/assign-prospects-contacts-or-leads-to-an-engage-flow-v2flowsprospectsassign-1
updated: 2026-09-27
---

# 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.