Skip to content

Newsletter Subscribe

Subscribe an email address to the newsletter.

Endpoint

POST /newsletter/subscribe

Request

Headers

Content-Type: application/json

Body

json
{
  "email": "user@example.com"
}

Parameters

FieldTypeRequiredDescription
emailstringYesValid email address to subscribe

Response

Success (201 Created)

json
{
  "data": null,
  "messages": [
    {
      "title": "Successfully subscribed to the newsletter."
    }
  ]
}

Error (400 Bad Request)

json
{
  "errors": [
    {
      "message": "Validation failed"
    }
  ]
}

Error (409 Conflict)

json
{
  "errors": [
    {
      "message": "This email is already subscribed to the newsletter."
    }
  ]
}

Notes

  • No authentication required (public endpoint)
  • Email is added to Brevo subscriber list
  • Welcome email sent via Resend
  • Duplicate subscriptions return 409 Conflict
  • GDPR-compliant unsubscribe link included in emails

Built with ❤️ by the Jubiloop team