MOmonta
Revenue Share

Apply a revenue-share policy to a team pair

Changed on

Required scope: revenue-share:write. Applies the policy identified by policyCode to the team pair.<br/><br/>Clients may send an Idempotency-Key header for safe retry semantics; the header is currently accepted and ignored (no enforcement yet).

post/api/v1/revenue-share/agreements

Request

  • Base URL
    https://partner-api.monta.com
  • URL
    https://partner-api.monta.com/api/v1/revenue-share/agreements
  • Auth
    HTTP bearer

Headers

Idempotency-Keystring
Example:01HX5Z6Q1ABC1234FZ7K9PQRDE

Opaque client-supplied key used for safe retries. Accepted today; behavior not yet enforced.

Request body

policyCodestring required

Code of the policy this agreement applies.

sourceTeamIdinteger required

Id of the team the revenue is shared from.

recipientTeamIdinteger required

Id of the team the revenue is shared to.

attributionSourceTeamIdinteger nullable

Optional id of the team charges are attributed to.

startedAtstring date-time nullable

Optional start of the agreement.

Example request

{
  "policyCode": "P-ACME-3",
  "sourceTeamId": 1024,
  "recipientTeamId": 2048,
  "attributionSourceTeamId": 1024,
  "startedAt": "2026-01-01T00:00:00Z"
}

Response

The created revenue-share agreement

codestring required

Stable code identifying the agreement.

policyCodestring nullable

Code of the policy this agreement applies.

policyVersioninteger nullable

Version of the policy this agreement applies.

sourceTeamIdinteger nullable

Id of the team the revenue is shared from.

sourceTeamNamestring nullable

Name of the team the revenue is shared from.

recipientTeamIdinteger nullable

Id of the team the revenue is shared to.

recipientTeamNamestring nullable

Name of the team the revenue is shared to.

attributionSourceTeamIdinteger nullable

Id of the team charges are attributed to.

status'Active' | 'Paused' | 'Other' required
startedAtstring date-time nullable

When the agreement started.

endedAtstring date-time nullable

When the agreement ended.

createdAtstring date-time nullable

Creation timestamp.

updatedAtstring date-time nullable

Last update timestamp.

Example response

{
  "code": "A-ACME-7",
  "policyCode": "P-ACME-3",
  "policyVersion": 1,
  "sourceTeamId": 1024,
  "sourceTeamName": "Acme Fleet",
  "recipientTeamId": 2048,
  "recipientTeamName": "Acme Sites",
  "attributionSourceTeamId": 1024,
  "startedAt": "2026-01-01T00:00:00Z",
  "endedAt": "2026-12-31T23:59:59Z"
}

Changes