> ## Documentation Index
> Fetch the complete documentation index at: https://learn.nexudus.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Announcement URL Visit

> Records a click-through on an announcement link.

# Announcement URL Visit

Records that a customer clicked through on an announcement's external URL. Used for tracking engagement with announcements.

## Authentication

Requires a valid customer bearer token.

## Query Parameters

<ParamField query="id" type="number" required>
  Numeric identifier of the announcement.
</ParamField>

## Response

Returns the external URL to open in the browser.

<ResponseField name="Url" type="string" required>
  The external URL associated with the announcement. The portal opens this in a new tab via `window.open()`.
</ResponseField>

## Examples

### Track announcement click

```http theme={null}
POST /api/public/announcements/visitUrl?id=10
Authorization: Bearer {token}
```

```json theme={null}
{
  "Url": "https://example.com/promo"
}
```

## TypeScript Integration

```typescript theme={null}
import endpoints from '@/api/endpoints'

const response = await httpClient.post<{ Url: string }>(endpoints.announcements.url(10))
window.open(response.data.Url, '_blank')
```