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

# Set event currency

`POST /sites/{site_id}/events/currency`

Set the currency of an event by its name. Use this instead of updating an event by its goal code. If more than one event row shares the name, they are treated as one event and every matching row is updated.

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

**Returns:** Returns an updated object on success. Otherwise, this call returns an error.

## 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', required — The currency used for any value attached to this event's completions.

## 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.

## Changes

- **2026-08-24** `93547ee49398` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/usefathom/apis/fathom-analytics-api/changes/sites/:site_id/events/currency/post.md)

---

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