Manage Events by Name Through the API
If you manage events through the Fathom API, you can now use the event names you already know to set currencies and delete event records. There’s no need to look up an old goal code first.
Set an event’s currency by name
Send a POST request to /v1/sites/{site_id}/events/currency with the event’s name and currency in the body. For example:
{
"name": "Purchase",
"currency": "pound"
}This sets the display currency for that event. It doesn’t convert the values you’ve collected. If your site has more than one event record with the same name, they’re treated as one event and all matching records are updated.
You’ll find the supported currencies and a complete request example in the Set event currency documentation.
Delete an event record by name
Send a DELETE request to /v1/sites/{site_id}/events, with the event name in the name query parameter. Names containing spaces or other special characters should be URL-encoded.
This removes the matching event records and their currency mapping. It doesn’t erase historical analytics or stop your site from sending that event. To stop collecting an event, use the Firewall’s Events list.
See Delete event for a complete example. Both of these endpoints need an API token with write access to the site.
Use names in your integrations
Event names are also the way to identify events in aggregation requests: pass site_id and entity_name to report on the event you want.
If your integration still uses goal codes, the old event IDs, now is a good time to move it to names. Our Events API documentation explains the replacement endpoints and changes to the older API.
Sep 20, 2026