Skip to main content

Transfer sequence task ownership

Transfer matching task ownership and, when requested, enrollment ownership for a sequence. Use dryRun to preview the matching changes before applying them.

POST/api/sequences/{sequence_id}/transfer-ownership
HTTP referenceScope sequences:writeUpdated September 27, 2026

This page documents the canonical HTTP contract for this endpoint.

This is a mutating workflow operation. In exit_and_reenroll mode, the selected enrollments can be exited and re-created under the new owner. The example uses dryRun:true. Obtain real organization user IDs from List organization users.

Path parameters

  • sequence_idrequired

    string

    Sequence identifier.

Body parameters

  • newUserIdrequired

    string

    Destination organization user ID.

  • leadIds · optional

    array<string>

    Restrict transfer to these lead IDs.

  • enrollmentIds · optional

    array<string>

    Restrict transfer to these enrollment IDs.

  • mode · optional

    string

    tasks_only (default), tasks_plus_enrollment, or exit_and_reenroll.

  • updateLeadOwner · optional

    boolean

    Also update the CRM lead owner; defaults to false.

  • dryRun · optional

    boolean

    Preview matching changes without applying; defaults to false.

Errors

StatusMeaning
401Authentication is missing or invalid.
403Missing sequences:write.
404Sequence or destination user not found.
400At least one of leadIds or enrollmentIds must be provided.

Docs