Create a newsletter widget
curl --request POST \
--url https://app.orgo.space/api/v1/newsletter_widgets \
--header 'Api-Token: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Boston Chapter",
"title": "Volunteer Coordinator",
"description": "Quarterly chapter meeting open to all members.",
"type": "MEMBER",
"widgetType": "string",
"heroImage": "https://cdn.orgo.space/events/12/cover.jpg",
"settings": [
"string"
],
"product": "/api/v1/products/1",
"isActive": true,
"tag": "/api/v1/tags/1"
}
'import requests
url = "https://app.orgo.space/api/v1/newsletter_widgets"
payload = {
"name": "Boston Chapter",
"title": "Volunteer Coordinator",
"description": "Quarterly chapter meeting open to all members.",
"type": "MEMBER",
"widgetType": "string",
"heroImage": "https://cdn.orgo.space/events/12/cover.jpg",
"settings": ["string"],
"product": "/api/v1/products/1",
"isActive": True,
"tag": "/api/v1/tags/1"
}
headers = {
"Api-Token": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Api-Token': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'Boston Chapter',
title: 'Volunteer Coordinator',
description: 'Quarterly chapter meeting open to all members.',
type: 'MEMBER',
widgetType: 'string',
heroImage: 'https://cdn.orgo.space/events/12/cover.jpg',
settings: ['string'],
product: '/api/v1/products/1',
isActive: true,
tag: '/api/v1/tags/1'
})
};
fetch('https://app.orgo.space/api/v1/newsletter_widgets', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.orgo.space/api/v1/newsletter_widgets",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Boston Chapter',
'title' => 'Volunteer Coordinator',
'description' => 'Quarterly chapter meeting open to all members.',
'type' => 'MEMBER',
'widgetType' => 'string',
'heroImage' => 'https://cdn.orgo.space/events/12/cover.jpg',
'settings' => [
'string'
],
'product' => '/api/v1/products/1',
'isActive' => true,
'tag' => '/api/v1/tags/1'
]),
CURLOPT_HTTPHEADER => [
"Api-Token: <api-key>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.orgo.space/api/v1/newsletter_widgets"
payload := strings.NewReader("{\n \"name\": \"Boston Chapter\",\n \"title\": \"Volunteer Coordinator\",\n \"description\": \"Quarterly chapter meeting open to all members.\",\n \"type\": \"MEMBER\",\n \"widgetType\": \"string\",\n \"heroImage\": \"https://cdn.orgo.space/events/12/cover.jpg\",\n \"settings\": [\n \"string\"\n ],\n \"product\": \"/api/v1/products/1\",\n \"isActive\": true,\n \"tag\": \"/api/v1/tags/1\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Api-Token", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.orgo.space/api/v1/newsletter_widgets")
.header("Api-Token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Boston Chapter\",\n \"title\": \"Volunteer Coordinator\",\n \"description\": \"Quarterly chapter meeting open to all members.\",\n \"type\": \"MEMBER\",\n \"widgetType\": \"string\",\n \"heroImage\": \"https://cdn.orgo.space/events/12/cover.jpg\",\n \"settings\": [\n \"string\"\n ],\n \"product\": \"/api/v1/products/1\",\n \"isActive\": true,\n \"tag\": \"/api/v1/tags/1\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.orgo.space/api/v1/newsletter_widgets")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Api-Token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"Boston Chapter\",\n \"title\": \"Volunteer Coordinator\",\n \"description\": \"Quarterly chapter meeting open to all members.\",\n \"type\": \"MEMBER\",\n \"widgetType\": \"string\",\n \"heroImage\": \"https://cdn.orgo.space/events/12/cover.jpg\",\n \"settings\": [\n \"string\"\n ],\n \"product\": \"/api/v1/products/1\",\n \"isActive\": true,\n \"tag\": \"/api/v1/tags/1\"\n}"
response = http.request(request)
puts response.read_body{
"id": 42,
"uuid": "01938d8e-9c4f-7c2a-b8e1-3f7a9b8c4f12",
"name": "Boston Chapter",
"title": "Volunteer Coordinator",
"description": "Quarterly chapter meeting open to all members.",
"type": "MEMBER",
"widgetType": "string",
"heroImage": "https://cdn.orgo.space/events/12/cover.jpg",
"settings": [
"string"
],
"tenant": "/api/v1/tenants/1",
"product": "/api/v1/products/1",
"isActive": true,
"createdAt": "2026-01-15T10:30:00+00:00",
"updatedAt": "2026-01-15T10:30:00+00:00",
"tag": "/api/v1/tags/1",
"subscriberCount": 12
}Widget
Create a newsletter widget
Creates a new newsletter subscription widget. Applies default newsletter settings if none provided. If this is the first newsletter widget for the tenant, it is automatically set as the default in tenant settings. Requires COMMUNICATION_TENANT or EVENT_TENANT permission.
POST
/
api
/
v1
/
newsletter_widgets
Create a newsletter widget
curl --request POST \
--url https://app.orgo.space/api/v1/newsletter_widgets \
--header 'Api-Token: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Boston Chapter",
"title": "Volunteer Coordinator",
"description": "Quarterly chapter meeting open to all members.",
"type": "MEMBER",
"widgetType": "string",
"heroImage": "https://cdn.orgo.space/events/12/cover.jpg",
"settings": [
"string"
],
"product": "/api/v1/products/1",
"isActive": true,
"tag": "/api/v1/tags/1"
}
'import requests
url = "https://app.orgo.space/api/v1/newsletter_widgets"
payload = {
"name": "Boston Chapter",
"title": "Volunteer Coordinator",
"description": "Quarterly chapter meeting open to all members.",
"type": "MEMBER",
"widgetType": "string",
"heroImage": "https://cdn.orgo.space/events/12/cover.jpg",
"settings": ["string"],
"product": "/api/v1/products/1",
"isActive": True,
"tag": "/api/v1/tags/1"
}
headers = {
"Api-Token": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Api-Token': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'Boston Chapter',
title: 'Volunteer Coordinator',
description: 'Quarterly chapter meeting open to all members.',
type: 'MEMBER',
widgetType: 'string',
heroImage: 'https://cdn.orgo.space/events/12/cover.jpg',
settings: ['string'],
product: '/api/v1/products/1',
isActive: true,
tag: '/api/v1/tags/1'
})
};
fetch('https://app.orgo.space/api/v1/newsletter_widgets', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.orgo.space/api/v1/newsletter_widgets",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Boston Chapter',
'title' => 'Volunteer Coordinator',
'description' => 'Quarterly chapter meeting open to all members.',
'type' => 'MEMBER',
'widgetType' => 'string',
'heroImage' => 'https://cdn.orgo.space/events/12/cover.jpg',
'settings' => [
'string'
],
'product' => '/api/v1/products/1',
'isActive' => true,
'tag' => '/api/v1/tags/1'
]),
CURLOPT_HTTPHEADER => [
"Api-Token: <api-key>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.orgo.space/api/v1/newsletter_widgets"
payload := strings.NewReader("{\n \"name\": \"Boston Chapter\",\n \"title\": \"Volunteer Coordinator\",\n \"description\": \"Quarterly chapter meeting open to all members.\",\n \"type\": \"MEMBER\",\n \"widgetType\": \"string\",\n \"heroImage\": \"https://cdn.orgo.space/events/12/cover.jpg\",\n \"settings\": [\n \"string\"\n ],\n \"product\": \"/api/v1/products/1\",\n \"isActive\": true,\n \"tag\": \"/api/v1/tags/1\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Api-Token", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.orgo.space/api/v1/newsletter_widgets")
.header("Api-Token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Boston Chapter\",\n \"title\": \"Volunteer Coordinator\",\n \"description\": \"Quarterly chapter meeting open to all members.\",\n \"type\": \"MEMBER\",\n \"widgetType\": \"string\",\n \"heroImage\": \"https://cdn.orgo.space/events/12/cover.jpg\",\n \"settings\": [\n \"string\"\n ],\n \"product\": \"/api/v1/products/1\",\n \"isActive\": true,\n \"tag\": \"/api/v1/tags/1\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.orgo.space/api/v1/newsletter_widgets")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Api-Token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"Boston Chapter\",\n \"title\": \"Volunteer Coordinator\",\n \"description\": \"Quarterly chapter meeting open to all members.\",\n \"type\": \"MEMBER\",\n \"widgetType\": \"string\",\n \"heroImage\": \"https://cdn.orgo.space/events/12/cover.jpg\",\n \"settings\": [\n \"string\"\n ],\n \"product\": \"/api/v1/products/1\",\n \"isActive\": true,\n \"tag\": \"/api/v1/tags/1\"\n}"
response = http.request(request)
puts response.read_body{
"id": 42,
"uuid": "01938d8e-9c4f-7c2a-b8e1-3f7a9b8c4f12",
"name": "Boston Chapter",
"title": "Volunteer Coordinator",
"description": "Quarterly chapter meeting open to all members.",
"type": "MEMBER",
"widgetType": "string",
"heroImage": "https://cdn.orgo.space/events/12/cover.jpg",
"settings": [
"string"
],
"tenant": "/api/v1/tenants/1",
"product": "/api/v1/products/1",
"isActive": true,
"createdAt": "2026-01-15T10:30:00+00:00",
"updatedAt": "2026-01-15T10:30:00+00:00",
"tag": "/api/v1/tags/1",
"subscriberCount": 12
}Authorizations
ApiTokenJWT
Server-to-server authentication. Generate a token in the admin UI at
Settings → Developers → API Access. Send the raw token in the
Api-Token header — there is no Bearer prefix.
Tokens can be marked read-only at creation time, in which case the API
rejects any non-GET request with 403 Forbidden.
Body
application/json
The new Widget resource
Example:
"/api/v1/products/1"
Example:
"/api/v1/tags/1"
Response
Widget resource created
Example:
"/api/v1/tenants/1"
Example:
"/api/v1/products/1"
Example:
"/api/v1/tags/1"
⌘I

