---
title: "Create event"
method: POST
path: "/sites/{site_id}/events"
tags: ["Events"]
---

# Create event

`POST /sites/{site_id}/events`

Create an event.

**Permissions:** Requires write access to the site (`manage:{site_id}`).

**Returns:** An event object.

## Path parameters

- `site_id` string, required

## Request body

- object
  - `name` string, required — The name of the event (up to 255 characters). Example: `Purchase early access`
  - `currency` 'dollar' | 'pound' | 'euro' | 'yuan' | 'peso' | 'shekel' | 'yen' | 'won' | 'hryvnia' | 'franc' | 'rupee' | 'integer' | 'none' — The currency used for any value attached to this event's completions. If omitted, defaults to `dollar`.

## Response `200`

Successful response

## Other responses

- `400` — Bad request. Returned for validation failures and other request problems. Send `Accept: application/json` to receive errors as JSON.
- `401` — Authentication failed — the API token is missing, malformed or invalid.

---

[API](https://skmtc.net/usefathom/apis/fathom-analytics-api.md) · [All operations](https://skmtc.net/usefathom/apis/fathom-analytics-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/usefathom/fathom-analytics-api/revisions/50679caad756/schema)