Programs and groups

Flows live on groups, so the group decides what its partners earn.

​

What each level is for

​

Programs or groups

​

Common group setups

• VIP group. Give the group its own flow at 40% and move top partners into it. Everyone else stays on the default 20%.
• Private group. Mark a group private and share its signup link only with influencers you invite. They land in that group with its own rates.
• Automatic promotion. A flow with the change_group action moves a partner to VIP once they pass, say, 10 paying customers.
• No-pay group. A group with no active commission flow earns nothing, as long as no program-wide flow applies. Useful for internal accounts.

​

Move a partner between groups

import { ToltApiClient } from "@tolt/api";

const tolt = new ToltApiClient({ token: process.env.TOLT_API_KEY! });

await tolt.partners.update({
  id: "part_8fKq2LmZx7RtYw3nVbHc5dPj",
  group_id: "grp_9VbKt3MwQ7xLr2ZnHy5cDfJp",
});

import os
from tolt import ToltApi

client = ToltApi(token=os.environ["TOLT_API_KEY"])

client.partners.update(
    id="part_8fKq2LmZx7RtYw3nVbHc5dPj",
    group_id="grp_9VbKt3MwQ7xLr2ZnHy5cDfJp",
)

ID=part_8fKq2LmZx7RtYw3nVbHc5dPj
curl -X PUT "https://platform.tolt.com/v2/partners/$ID" \
  -H "Authorization: Bearer $TOLT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "group_id": "grp_9VbKt3MwQ7xLr2ZnHy5cDfJp" }'