Contacts

Bulk-move all matching contacts to a target pipeline stage

PUT
/api/contacts/query-bulk-move

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
AuthorizationBearer <token>

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}