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

# Subscribe to Newsletter

> Subscribes the current user or email address to the location newsletter.

# Subscribe to Newsletter

Registers an email address for the location's newsletter. Can be called by authenticated customers or public visitors providing an email address.

## Authentication

No authentication required for public subscription.

## Request Body

<ParamField body="Email" type="string" required>
  Email address to subscribe.
</ParamField>

## Response

<ResponseField name="WasSuccessful" type="boolean" required>
  `true` if the subscription was created or already existed.
</ResponseField>

## Examples

### Subscribe

```http theme={null}
POST /api/public/newsletter/subscribe
Content-Type: application/json

{
  "Email": "visitor@example.com"
}
```

```json theme={null}
{
  "WasSuccessful": true
}
```

## TypeScript Integration

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

const result = await httpClient.post(endpoints.newsletter.subscribe().url, {
  Email: 'visitor@example.com',
})
```