Subscribe to Newsletter

Subscribe an email address to the workspace's list from its public site — the Hub and Publishing Home subscribe forms. Rate limited to 10 requests per minute per IP, and 10 attempts per 10 minutes for the same email address. Returns only an outcome, never the subscriber record, since the endpoint is unauthenticated.

Signups that look like spam still get a success response: the most blatant are dropped silently, and likely spam is saved with a risk mark that Audience's spam cleanup takes into account.

curl -X POST "https://app.nashra.ai/api/v1/tenants/example_string/subscribe" \
  -H "Content-Type: application/json" \
  -d '{
  "email": "reader@example.com",
  "name": "Jamie",
  "phone": "+966501234567",
  "phone_country": "SA",
  "tags": [
    "newsletter-widget"
  ],
  "visitor_id": "123e4567-e89b-12d3-a456-426614174000",
  "website": "example_string"
}'

import requests
import json

url = "https://app.nashra.ai/api/v1/tenants/example_string/subscribe"
headers = {
  "Content-Type": "application/json"
}
data = {
  "email": "reader@example.com",
  "name": "Jamie",
  "phone": "+966501234567",
  "phone_country": "SA",
  "tags": [
    "newsletter-widget"
  ],
  "visitor_id": "123e4567-e89b-12d3-a456-426614174000",
  "website": "example_string"
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

const response = await fetch("https://app.nashra.ai/api/v1/tenants/example_string/subscribe", {
  method: "POST",
  headers: {
  "Content-Type": "application/json"
},
  body: JSON.stringify({
  "email": "reader@example.com",
  "name": "Jamie",
  "phone": "+966501234567",
  "phone_country": "SA",
  "tags": [
    "newsletter-widget"
  ],
  "visitor_id": "123e4567-e89b-12d3-a456-426614174000",
  "website": "example_string"
})
});

const data = await response.json();
console.log(data);

package main

import (
    "fmt"
    "net/http"
    "bytes"
    "encoding/json"
)

func main() {
    data := []byte(`{
  "email": "reader@example.com",
  "name": "Jamie",
  "phone": "+966501234567",
  "phone_country": "SA",
  "tags": [
    "newsletter-widget"
  ],
  "visitor_id": "123e4567-e89b-12d3-a456-426614174000",
  "website": "example_string"
}`)

    req, err := http.NewRequest("POST", "https://app.nashra.ai/api/v1/tenants/example_string/subscribe", bytes.NewBuffer(data))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    fmt.Println("Response Status:", resp.Status)
}

require 'net/http'
require 'json'

uri = URI('https://app.nashra.ai/api/v1/tenants/example_string/subscribe')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
  "email": "reader@example.com",
  "name": "Jamie",
  "phone": "+966501234567",
  "phone_country": "SA",
  "tags": [
    "newsletter-widget"
  ],
  "visitor_id": "123e4567-e89b-12d3-a456-426614174000",
  "website": "example_string"
}'

response = http.request(request)
puts response.body

{
  "data": {
    "subscribed": true,
    "reader_number": 1284
  },
  "message": "Successfully subscribed to newsletter",
  "meta": {}
}

{
  "error": "Unprocessable Entity",
  "message": "The request was well-formed but contains semantic errors",
  "code": 422,
  "details": [
    {
      "field": "password",
      "message": "Password must be at least 8 characters long"
    }
  ]
}