Create Distributor

POST /siren/v1/distributors

Creates a new distributor record.

Request Body:

Field	Type	Required	Description
name	string	Yes	Distributor name
description	string	Yes	Human-readable description
distributionResolver	string	Yes	Incentive resolver identifier (must be a registered resolver)
distributionPoolResolver	string	Yes	Pool resolver identifier
status	string	Yes	Initial status: active or inactive
units	string	Yes	Currency identifier (must be a registered currency)
schedule	string[]	No	Array of DateTime modifier strings for distribution scheduling

Example Request:

{
  "name": "Monthly Commission",
  "description": "Monthly percentage-based commission distribution",
  "distributionResolver": "percentage_based",
  "distributionPoolResolver": "standard_pool",
  "status": "active",
  "units": "USD",
  "schedule": ["first day of next month"]
}

Example Response:

{
  "id": 2,
  "name": "Monthly Commission",
  "description": "Monthly percentage-based commission distribution",
  "distributionResolver": "percentage_based",
  "distributionPoolResolver": "standard_pool",
  "status": "active",
  "units": "USD",
  "dateCreated": "2026-04-08T12:00:00Z",
  "dateModified": "2026-04-08T12:00:00Z"
}

Events: Broadcasts DistributorActionEvent (action: Create) after success.