FirstPromoter icon

FirstPromoter

Interact with the official FirstPromoter APIs

Promoter → Assign Parent

AI-generated

Summary

Assign a specified parent promoter to one or multiple promoters identified by their IDs.

Inputs

  • Parent Promoter ID — The ID of the parent promoter to assign to the listed promoters.
  • IDs (required) — One or more IDs of promoters to assign the parent promoter to. If more than 5 IDs are provided, the assignment is processed asynchronously with statuses such as pending, in_progress, completed, failed, and stopped.

Output shape

a single JSON object containing the API response to the assignment request, wrapped in an array

The operation returns the result from the FirstPromoter API confirmational endpoint /company/promoters/assign_parent. If the number of promoter IDs exceeds 5, the process is asynchronous and the status of the assignment can be monitored.

Examples

Example 1: Assign parent promoter with ID '123' to promoters with IDs 1, 2, 3.

Provide 'parentPromoterId' as '123' and 'ids' as [1,2,3] to assign parent promoter to these promoters.

Links

Discussion