---
title: "Report the ad click the signed-in person arrived with"
method: POST
path: "/v1/workspaces/{workspaceId}/analytics/ad-click"
---

# Report the ad click the signed-in person arrived with

`POST /v1/workspaces/{workspaceId}/analytics/ad-click`

## Request

- Base URL: `https://api.bangermail.com`
- URL: `https://api.bangermail.com/v1/workspaces/{workspaceId}/analytics/ad-click`
- Auth: HTTP bearer

The web app hands over the ad click IDs a person arrived with, once, after sign-in. The first click is stored on the account; when the account is new, its signup is reported to Google Ads and Meta. Requires a signed-in human session; API keys are rejected.

## Path parameters

- `workspaceId` string, uuid, required

## Request body

- object
  - `gclid` string
  - `gbraid` string
  - `wbraid` string
  - `fbclid` string
  - `fbc` string: Meta click cookie value, fb.1.<ms>.<fbclid>.
  - `fbp` string: Meta browser cookie value, fb.1.<ms>.<random>.
  - `utm_source` string
  - `utm_medium` string
  - `utm_campaign` string
  - `utm_term` string
  - `utm_content` string

## Response `200`

Successful response.

- object
  - `data` object, required
    - `status` 'reported' | 'recorded' | 'already_recorded', required

## Other responses

- `default`: Request failed.

## Changes

- **2026-10-20** `a149909267f9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bangermail/apis/banger-api/changes/v1/workspaces/:workspaceId/analytics/ad-click/post.md)

---

[API](https://skmtc.dev/bangermail/apis/banger-api.md) · [All operations](https://skmtc.dev/bangermail/apis/banger-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bangermail/apis/banger-api/revisions/a149909267f9?raw)