← Back to Overview

Promote

Record when a lower-cost payment method was promoted to a customer

POST/api/push/promoteOptional Auth
publicproductoptional-auth

Example Request

cURL

curl -X POST https://margin.so/api/push/promote \
  -H "Content-Type: application/json" \
  -H "X-API-Key: sk_live_your_api_key_here" \
  -d '{}'

JavaScript

const response = await fetch('https://margin.so/api/push/promote', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'sk_live_your_api_key_here'
  },
  body: JSON.stringify({})
});

const data = await response.json();
console.log(data);

Python

import requests

response = requests.post(
    'https://margin.so/api/push/promote',
    headers={
        'Content-Type': 'application/json',
        'X-API-Key': 'sk_live_your_api_key_here'
    },
    json={}
)

data = response.json()
print(data)

Example Response

{
  "success": true,
  "data": {
    "event_id": "evt_promotion_abc123",
    "method": "sepa_instant",
    "promoted_at": "2025-12-25T10:00:00Z"
  }
}

Request Body

FieldTypeRequiredDescription