# Schedule rev share

`POST https://api.nexus.gg/v1/manage/scheduled-rev-shares`

Creates a scheduled revenue-share override for a creator group, covering `startDate` through `endDate`. Provide a flat `revShare` for the whole group, override specific tiers via `tierRevenueShares`, or both. The request is rejected if you send neither.

Only one non-deleted schedule may cover a group's date range at a time. If the window you request overlaps any other active schedule for the group, the call returns `409` rather than replacing it, and this is not idempotent: calling it twice with the same overlapping window creates the first schedule and rejects the second.

Send `revShare` and each `tierRevenueShares[].revShare` as a number from 1 to 100. Internally the value is only converted to a stored fraction when it is greater than 1, so sending exactly `1` (meaning 1%) is stored as a 100% share instead. Avoid sending exactly `1` until this is fixed; see the reported flag.

This method authenticates with a **secret** (`nexus_sk_...`) key, so call it from your back-end, never from a game client.

## Authorizations

- `X-SHARED-SECRET` (string, header, required) - Send your **secret** API key (`nexus_sk_...`) in the `X-SHARED-SECRET` header. [Generate one](/authentication/api-keys/) in the Publisher Dashboard.

## Query parameters

- `groupId` (string) - Creator group to schedule the override for. If your key is scoped to a single program, that group is always used regardless of this value; otherwise falls back to your default group when omitted.

## Request body (`application/json`)

- `revShare` (number) - Flat revenue-share percentage for the whole group during this window, 1 to 100. Provide this, tierRevenueShares, or both, at least one is required.
- `startDate` (string) - Start of the override window. ISO 8601, in UTC.
- `endDate` (string) - End of the override window. Must be after startDate. ISO 8601, in UTC.
- `tierRevenueShares` (array of object)

## Responses

### 200

Scheduled rev share that was created

#### Body (`application/json`)

- `id` (string)
- `revShare` (number) - Group-wide revenue-share percentage for this schedule's window (25 means 25%). Falls back to the group's normal, non-scheduled default when the schedule only carries tier-specific overrides.
- `startDate` (string)
- `endDate` (string)
- `groupId` (string)
- `groupName` (string)
- `tierRevenueShares` (array of object)

### 400

The request body failed schema validation (missing startDate/endDate, neither revShare nor tierRevenueShares sent, or a revShare outside 1-100), which returns a JSON body with an errors array, or endDate is before startDate, which returns a plain-text message instead.

### 404

The resolved creator group (from groupId, your key's scoped group, or your publisher's default group) did not match a creator group on your publisher account.

### 409

The requested window overlaps another non-deleted revenue share for this group. Only one schedule may cover a given date range.