Contacts
Bulk-move all matching contacts to a target pipeline stage
Moves every contact matching the supplied filter into the given pipeline stage. targetStageId and targetStatus are both required; the server resolves the underlying pipelineId from targetStageId and writes all three. For each contact whose status, pipelineStage, or pipelineId actually changes, the server records a stage-transition history entry, emits a contact_updated socket event, and writes a manual-event audit entry (CONTACT_UPDATE). Filter semantics are identical to query-count: either provide stageIds[] or orgWide: true.
Authorization
bearerAuth In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
curl -X PUT "https://example.com/api/contacts/query-bulk-move" \ -H "Content-Type: application/json" \ -d '{ "stageIds": [ "64b2c3d4e5f60012345678aa" ], "orgWide": false, "targetStageId": "64b2c3d4e5f60012345678bb", "targetStatus": "Contacted" }'{ "message": "Successfully moved 1428 contact(s)", "modifiedCount": 1428, "matchedCount": 1500}