Subscribe to newsletter (public)

POST

/api/v1/newsletter/subscribe

Header Parameters

Request Body

application/json

body

email*string

Email address to subscribe

firstName?string

First name (optional)

lastName?string

Last name (optional)

Response Body

Successfully subscribed to newsletter

response?unknownapplication/json

Example Request

curl -X POST 'http://localhost:3001/api/v1/newsletter/subscribe' \
  -H 'Content-Type: application/json' \
  -d '{
  "email": "john.doe@example.com"
}'

Example Request

curl -X POST 'http://localhost:3001/api/v1/newsletter/subscribe' \  -H 'Content-Type: application/json' \  -d '{  "email": "john.doe@example.com"}'

Example ResponseSchema

{
  "status": "success",
  "statusCode": 201,
  "message": "Successfully subscribed to newsletter",
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "email": "user@example.com",
    "firstName": "John",
    "lastName": "Doe",
    "isActive": true,
    "subscribedAt": "2026-02-01T10:00:00.000Z"
  },
  "meta": {
    "subscriber_id": "123e4567-e89b-12d3-a456-426614174000",
    "subscribed_at": "2026-02-01T10:00:00.000Z"
  }
}

{  "status": "success",  "statusCode": 201,  "message": "Successfully subscribed to newsletter",  "data": {    "id": "123e4567-e89b-12d3-a456-426614174000",    "email": "user@example.com",    "firstName": "John",    "lastName": "Doe",    "isActive": true,    "subscribedAt": "2026-02-01T10:00:00.000Z"  },  "meta": {    "subscriber_id": "123e4567-e89b-12d3-a456-426614174000",    "subscribed_at": "2026-02-01T10:00:00.000Z"  }}

Subscribe to newsletter (public)

Header ParametersCopy Anchor Link

Request BodyCopy Anchor Link

Response BodyCopy Anchor Link

Header Parameters

Request Body

Response Body