Skip to main content
POST
Set Target

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Set a monthly revenue target for one of your reports.

Endpoint: POST /api/v1/commissions/targets Required realm role: business_manager, commercial_manager, commercial_director

Setting a target replaces any existing target for the same applicant × category × period, so managers can correct mistakes before the application window opens.

A BM covering two categories must set two separate targets — one per category.

applicant_id
string<uuid>
required

User ID of the person this target is for.

applicant_role
enum<string>
required

Role of the applicant — determines which commission tier schedule applies.

Available options:
BSE,
BM,
CM,
CD,
FREELANCE
category
enum<string>
required

Business category this target covers.

Available options:
Direct,
Agency,
Digital,
Government
month
integer
required

Commission month (1–12), e.g. 5 for May.

Required range: 1 <= x <= 12
year
integer
required

Commission year, e.g. 2026.

Required range: x >= 2020
target_amount
required

Monthly revenue target in KES.

Required range: x > 0

Response

Successful Response