Siren

Create Conversion

Create a new conversion record linked to an engagement.

Last updated: October 26, 2026

Create Conversion

POST /siren/v1/conversions

Creates a new conversion record.

Request Body

FieldTypeRequiredDescription
engagementIdintegerYesID of the associated engagement (must exist)
typestringYesConversion type identifier
statusstringYesInitial status: pending, approved, rejected, or expired. The value is stored as sent, and no approval runs, so send pending and approve the conversion afterwards to make its obligation payable
transactionIdintegerNoID of associated transaction
obligationIdintegerNoID of associated obligation

Example Request

{
  "engagementId": 15,
  "type": "sale",
  "status": "pending"
}

Example Response

{
  "id": 43,
  "engagementId": 15,
  "transactionId": null,
  "obligationId": null,
  "type": "sale",
  "status": "pending",
  "dateCreated": "2026-04-06T12:00:00Z",
  "dateModified": "2026-04-06T12:00:00Z",
  "wonZeroReward": 0
}

Events

Broadcasts ConversionActionEvent (action: Create) after success.

Your privacy choices

Account, checkout and chat you request work without optional tracking. Choose whether to allow these other uses on this website.

You can change or withdraw your choices at any time using “Privacy choices.” We remember your choice for 180 days. Read our privacy policy.