---
title: "POST /events"
method: POST
path: "/events"
---

# POST /events

`POST /events`

Report referral-related events such as signups, purchases, and refunds.

## Request body

- EventEnvelope
  - `eventName` 'ReferralUpdated', required
  - `payload` EventPayload, required
    - `ucc` string, required
    - `newUserId` string, required
    - `price` number
    - `currency` string
  - `context` EventContext, required
    - `event` object
      - `trigger` 'new-signup' | 'demo-call-attended' | 'invoice-paid' | 'charge-refunded', required
      - `timestamp` string, date-time, required
    - `newUser` object
      - `id` string
      - `email` string, email
      - `name` string
      - `organizationId` string
    - `subscription` object
      - `id` string
      - `invoiceId` string
      - `interval` 'one-time' | 'weekly' | 'bi-weekly' | 'monthly' | 'quarterly' | 'semi-annual' | 'yearly' | 'biennial' | 'triennial' | 'lifetime'
      - `seatsUsed` integer
      - `productKey` string

## Response `200`

Event accepted

- object
  - `success` boolean

## Other responses

- `400` — Malformed or invalid data
- `401` — Unauthorized

---

[API](https://skmtc.net/cello/apis/cello-api.md) · [All operations](https://skmtc.net/cello/apis/cello-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cello/cello-api/versions/e5444152ea7e/schema)