curl --request POST \
--url https://app.orgo.space/api/v1/contacts/{id}/send-email \
--header 'Api-Token: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Boston Chapter",
"middleName": "L.",
"email": "james.patterson@example.com",
"phone": "+1 415 555 0142",
"isEventAppPhonePrivate": true,
"isEventAppEmailPrivate": true,
"prefEventAppOnboardingSeen": true,
"isEventAppProfilePublic": true,
"organisation": "Civic Collective",
"role": "ROLE_USER",
"twitter": "https://twitter.com/jpatterson",
"linkedin": "https://linkedin.com/in/james-patterson",
"instagram": "https://instagram.com/jpatterson",
"bsky": "@jpatterson.bsky.social",
"bio": "Volunteer organizer in the Boston chapter since 2022.",
"country": "/api/v1/countries/1",
"town": "/api/v1/towns/1",
"isEmailConfirmed": true,
"localCenter": "/api/v1/local_centers/1",
"companyIdentifier": "US-123456789",
"companyName": "Civic Collective LLC",
"companyAddress": "123 Beacon Street, Boston, MA 02108",
"customFieldValues": [
"/api/v1/custom_field_values/1"
],
"professionOrganisationRole": "Civic Collective",
"companyRegNo": "DE-HRB-12345",
"status": "/api/v1/profile_statuses/1",
"gender": "M",
"dateBirth": "2026-01-15T10:30:00+00:00",
"personalIdNumber": "string"
}
'import requests
url = "https://app.orgo.space/api/v1/contacts/{id}/send-email"
payload = {
"name": "Boston Chapter",
"middleName": "L.",
"email": "james.patterson@example.com",
"phone": "+1 415 555 0142",
"isEventAppPhonePrivate": True,
"isEventAppEmailPrivate": True,
"prefEventAppOnboardingSeen": True,
"isEventAppProfilePublic": True,
"organisation": "Civic Collective",
"role": "ROLE_USER",
"twitter": "https://twitter.com/jpatterson",
"linkedin": "https://linkedin.com/in/james-patterson",
"instagram": "https://instagram.com/jpatterson",
"bsky": "@jpatterson.bsky.social",
"bio": "Volunteer organizer in the Boston chapter since 2022.",
"country": "/api/v1/countries/1",
"town": "/api/v1/towns/1",
"isEmailConfirmed": True,
"localCenter": "/api/v1/local_centers/1",
"companyIdentifier": "US-123456789",
"companyName": "Civic Collective LLC",
"companyAddress": "123 Beacon Street, Boston, MA 02108",
"customFieldValues": ["/api/v1/custom_field_values/1"],
"professionOrganisationRole": "Civic Collective",
"companyRegNo": "DE-HRB-12345",
"status": "/api/v1/profile_statuses/1",
"gender": "M",
"dateBirth": "2026-01-15T10:30:00+00:00",
"personalIdNumber": "string"
}
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',
middleName: 'L.',
email: 'james.patterson@example.com',
phone: '+1 415 555 0142',
isEventAppPhonePrivate: true,
isEventAppEmailPrivate: true,
prefEventAppOnboardingSeen: true,
isEventAppProfilePublic: true,
organisation: 'Civic Collective',
role: 'ROLE_USER',
twitter: 'https://twitter.com/jpatterson',
linkedin: 'https://linkedin.com/in/james-patterson',
instagram: 'https://instagram.com/jpatterson',
bsky: '@jpatterson.bsky.social',
bio: 'Volunteer organizer in the Boston chapter since 2022.',
country: '/api/v1/countries/1',
town: '/api/v1/towns/1',
isEmailConfirmed: true,
localCenter: '/api/v1/local_centers/1',
companyIdentifier: 'US-123456789',
companyName: 'Civic Collective LLC',
companyAddress: '123 Beacon Street, Boston, MA 02108',
customFieldValues: ['/api/v1/custom_field_values/1'],
professionOrganisationRole: 'Civic Collective',
companyRegNo: 'DE-HRB-12345',
status: '/api/v1/profile_statuses/1',
gender: 'M',
dateBirth: '2026-01-15T10:30:00+00:00',
personalIdNumber: 'string'
})
};
fetch('https://app.orgo.space/api/v1/contacts/{id}/send-email', 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/contacts/{id}/send-email",
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',
'middleName' => 'L.',
'email' => 'james.patterson@example.com',
'phone' => '+1 415 555 0142',
'isEventAppPhonePrivate' => true,
'isEventAppEmailPrivate' => true,
'prefEventAppOnboardingSeen' => true,
'isEventAppProfilePublic' => true,
'organisation' => 'Civic Collective',
'role' => 'ROLE_USER',
'twitter' => 'https://twitter.com/jpatterson',
'linkedin' => 'https://linkedin.com/in/james-patterson',
'instagram' => 'https://instagram.com/jpatterson',
'bsky' => '@jpatterson.bsky.social',
'bio' => 'Volunteer organizer in the Boston chapter since 2022.',
'country' => '/api/v1/countries/1',
'town' => '/api/v1/towns/1',
'isEmailConfirmed' => true,
'localCenter' => '/api/v1/local_centers/1',
'companyIdentifier' => 'US-123456789',
'companyName' => 'Civic Collective LLC',
'companyAddress' => '123 Beacon Street, Boston, MA 02108',
'customFieldValues' => [
'/api/v1/custom_field_values/1'
],
'professionOrganisationRole' => 'Civic Collective',
'companyRegNo' => 'DE-HRB-12345',
'status' => '/api/v1/profile_statuses/1',
'gender' => 'M',
'dateBirth' => '2026-01-15T10:30:00+00:00',
'personalIdNumber' => 'string'
]),
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/contacts/{id}/send-email"
payload := strings.NewReader("{\n \"name\": \"Boston Chapter\",\n \"middleName\": \"L.\",\n \"email\": \"james.patterson@example.com\",\n \"phone\": \"+1 415 555 0142\",\n \"isEventAppPhonePrivate\": true,\n \"isEventAppEmailPrivate\": true,\n \"prefEventAppOnboardingSeen\": true,\n \"isEventAppProfilePublic\": true,\n \"organisation\": \"Civic Collective\",\n \"role\": \"ROLE_USER\",\n \"twitter\": \"https://twitter.com/jpatterson\",\n \"linkedin\": \"https://linkedin.com/in/james-patterson\",\n \"instagram\": \"https://instagram.com/jpatterson\",\n \"bsky\": \"@jpatterson.bsky.social\",\n \"bio\": \"Volunteer organizer in the Boston chapter since 2022.\",\n \"country\": \"/api/v1/countries/1\",\n \"town\": \"/api/v1/towns/1\",\n \"isEmailConfirmed\": true,\n \"localCenter\": \"/api/v1/local_centers/1\",\n \"companyIdentifier\": \"US-123456789\",\n \"companyName\": \"Civic Collective LLC\",\n \"companyAddress\": \"123 Beacon Street, Boston, MA 02108\",\n \"customFieldValues\": [\n \"/api/v1/custom_field_values/1\"\n ],\n \"professionOrganisationRole\": \"Civic Collective\",\n \"companyRegNo\": \"DE-HRB-12345\",\n \"status\": \"/api/v1/profile_statuses/1\",\n \"gender\": \"M\",\n \"dateBirth\": \"2026-01-15T10:30:00+00:00\",\n \"personalIdNumber\": \"string\"\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/contacts/{id}/send-email")
.header("Api-Token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Boston Chapter\",\n \"middleName\": \"L.\",\n \"email\": \"james.patterson@example.com\",\n \"phone\": \"+1 415 555 0142\",\n \"isEventAppPhonePrivate\": true,\n \"isEventAppEmailPrivate\": true,\n \"prefEventAppOnboardingSeen\": true,\n \"isEventAppProfilePublic\": true,\n \"organisation\": \"Civic Collective\",\n \"role\": \"ROLE_USER\",\n \"twitter\": \"https://twitter.com/jpatterson\",\n \"linkedin\": \"https://linkedin.com/in/james-patterson\",\n \"instagram\": \"https://instagram.com/jpatterson\",\n \"bsky\": \"@jpatterson.bsky.social\",\n \"bio\": \"Volunteer organizer in the Boston chapter since 2022.\",\n \"country\": \"/api/v1/countries/1\",\n \"town\": \"/api/v1/towns/1\",\n \"isEmailConfirmed\": true,\n \"localCenter\": \"/api/v1/local_centers/1\",\n \"companyIdentifier\": \"US-123456789\",\n \"companyName\": \"Civic Collective LLC\",\n \"companyAddress\": \"123 Beacon Street, Boston, MA 02108\",\n \"customFieldValues\": [\n \"/api/v1/custom_field_values/1\"\n ],\n \"professionOrganisationRole\": \"Civic Collective\",\n \"companyRegNo\": \"DE-HRB-12345\",\n \"status\": \"/api/v1/profile_statuses/1\",\n \"gender\": \"M\",\n \"dateBirth\": \"2026-01-15T10:30:00+00:00\",\n \"personalIdNumber\": \"string\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.orgo.space/api/v1/contacts/{id}/send-email")
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 \"middleName\": \"L.\",\n \"email\": \"james.patterson@example.com\",\n \"phone\": \"+1 415 555 0142\",\n \"isEventAppPhonePrivate\": true,\n \"isEventAppEmailPrivate\": true,\n \"prefEventAppOnboardingSeen\": true,\n \"isEventAppProfilePublic\": true,\n \"organisation\": \"Civic Collective\",\n \"role\": \"ROLE_USER\",\n \"twitter\": \"https://twitter.com/jpatterson\",\n \"linkedin\": \"https://linkedin.com/in/james-patterson\",\n \"instagram\": \"https://instagram.com/jpatterson\",\n \"bsky\": \"@jpatterson.bsky.social\",\n \"bio\": \"Volunteer organizer in the Boston chapter since 2022.\",\n \"country\": \"/api/v1/countries/1\",\n \"town\": \"/api/v1/towns/1\",\n \"isEmailConfirmed\": true,\n \"localCenter\": \"/api/v1/local_centers/1\",\n \"companyIdentifier\": \"US-123456789\",\n \"companyName\": \"Civic Collective LLC\",\n \"companyAddress\": \"123 Beacon Street, Boston, MA 02108\",\n \"customFieldValues\": [\n \"/api/v1/custom_field_values/1\"\n ],\n \"professionOrganisationRole\": \"Civic Collective\",\n \"companyRegNo\": \"DE-HRB-12345\",\n \"status\": \"/api/v1/profile_statuses/1\",\n \"gender\": \"M\",\n \"dateBirth\": \"2026-01-15T10:30:00+00:00\",\n \"personalIdNumber\": \"string\"\n}"
response = http.request(request)
puts response.read_body{
"id": 42,
"name": "Boston Chapter",
"middleName": "L.",
"email": "james.patterson@example.com",
"phone": "+1 415 555 0142",
"isEventAppPhonePrivate": true,
"isEventAppEmailPrivate": true,
"prefEventAppOnboardingSeen": true,
"isEventAppProfilePublic": true,
"organisation": "Civic Collective",
"role": "ROLE_USER",
"twitter": "https://twitter.com/jpatterson",
"linkedin": "https://linkedin.com/in/james-patterson",
"instagram": "https://instagram.com/jpatterson",
"bsky": "@jpatterson.bsky.social",
"logo": "https://cdn.orgo.space/tenants/acme/logo.png",
"bio": "Volunteer organizer in the Boston chapter since 2022.",
"country": {
"id": 42,
"name": "Boston Chapter"
},
"isNewsletterSubscribed": true,
"stripeCustomerId": "cus_NhpBuxIyR4Qbpd",
"town": {
"id": 42,
"name": "Boston Chapter",
"country": {
"id": 42,
"name": "Boston Chapter"
}
},
"dateCreated": "2026-01-15T10:30:00+00:00",
"isValidatedIdentity": true,
"isValidatedIdentityPending": true,
"identity": {
"id": 42,
"isValidated": true,
"hasUploadedDocument": true,
"idAddress": "123 Beacon Street, Boston, MA 02108",
"status": "ACTIVE",
"addressStreet": "123 Beacon Street, Boston, MA 02108",
"addressDetails": "123 Beacon Street, Boston, MA 02108"
},
"isEmailConfirmed": true,
"localCenter": {
"id": 42,
"name": "Boston Chapter"
},
"product": "/api/v1/products/1",
"companyIdentifier": "US-123456789",
"companyName": "Civic Collective LLC",
"companyAddress": "123 Beacon Street, Boston, MA 02108",
"customFieldValues": [
{
"id": 42,
"field": {
"id": 42,
"name": "Boston Chapter",
"fieldType": "string"
},
"value": "Vegetarian",
"media": {
"id": 42,
"size": 42,
"contentUrl": "https://civic-collective.example.com",
"mimeType": "application/pdf",
"originalName": "Boston Chapter"
},
"dateCreated": "2026-01-15T10:30:00+00:00"
}
],
"professionOrganisationRole": "Civic Collective",
"companyRegNo": "DE-HRB-12345",
"status": {
"id": 42,
"name": "Boston Chapter",
"color": "#16A34A",
"position": 42
},
"lastStatusUpdate": "2026-01-15T10:30:00+00:00",
"tags": [
{
"id": 42,
"tag": {
"id": 42,
"name": "Boston Chapter"
},
"createdAt": "2026-01-15T10:30:00+00:00"
}
],
"contactNotes": [
{
"uuid": "01938d8e-9c4f-7c2a-b8e1-3f7a9b8c4f12",
"text": "Hello, you're invited to the Annual General Meeting.",
"action": "string",
"dateCreated": "2026-01-15T10:30:00+00:00",
"dateUpdated": "2026-01-15T10:30:00+00:00",
"authorName": "Boston Chapter",
"authorId": 42,
"authorLogo": "https://cdn.orgo.space/tenants/acme/logo.png"
}
],
"gender": "M",
"dateBirth": "2026-01-15T10:30:00+00:00",
"source": "string",
"fullName": "James Patterson",
"firstName": "James",
"lastName": "Patterson",
"age": 34,
"hasPersonalIdNumber": true
}Send a one-off custom email to a contact
Admin-initiated one-to-one email. Accepts a JSON body with subject (plain text) and body (HTML). The HTML is sanitized server-side, wrapped in the tenant email layout by UnifiedEmailService, and sent with RFC 8058 one-click unsubscribe headers. Requires COMMUNICATION_LOCAL on the contact local center (COMMUNICATION_TENANT and ADMIN_TENANT satisfy it); tenant isolation enforced; rate-limited to 30 sends per hour per admin; logged for audit.
curl --request POST \
--url https://app.orgo.space/api/v1/contacts/{id}/send-email \
--header 'Api-Token: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Boston Chapter",
"middleName": "L.",
"email": "james.patterson@example.com",
"phone": "+1 415 555 0142",
"isEventAppPhonePrivate": true,
"isEventAppEmailPrivate": true,
"prefEventAppOnboardingSeen": true,
"isEventAppProfilePublic": true,
"organisation": "Civic Collective",
"role": "ROLE_USER",
"twitter": "https://twitter.com/jpatterson",
"linkedin": "https://linkedin.com/in/james-patterson",
"instagram": "https://instagram.com/jpatterson",
"bsky": "@jpatterson.bsky.social",
"bio": "Volunteer organizer in the Boston chapter since 2022.",
"country": "/api/v1/countries/1",
"town": "/api/v1/towns/1",
"isEmailConfirmed": true,
"localCenter": "/api/v1/local_centers/1",
"companyIdentifier": "US-123456789",
"companyName": "Civic Collective LLC",
"companyAddress": "123 Beacon Street, Boston, MA 02108",
"customFieldValues": [
"/api/v1/custom_field_values/1"
],
"professionOrganisationRole": "Civic Collective",
"companyRegNo": "DE-HRB-12345",
"status": "/api/v1/profile_statuses/1",
"gender": "M",
"dateBirth": "2026-01-15T10:30:00+00:00",
"personalIdNumber": "string"
}
'import requests
url = "https://app.orgo.space/api/v1/contacts/{id}/send-email"
payload = {
"name": "Boston Chapter",
"middleName": "L.",
"email": "james.patterson@example.com",
"phone": "+1 415 555 0142",
"isEventAppPhonePrivate": True,
"isEventAppEmailPrivate": True,
"prefEventAppOnboardingSeen": True,
"isEventAppProfilePublic": True,
"organisation": "Civic Collective",
"role": "ROLE_USER",
"twitter": "https://twitter.com/jpatterson",
"linkedin": "https://linkedin.com/in/james-patterson",
"instagram": "https://instagram.com/jpatterson",
"bsky": "@jpatterson.bsky.social",
"bio": "Volunteer organizer in the Boston chapter since 2022.",
"country": "/api/v1/countries/1",
"town": "/api/v1/towns/1",
"isEmailConfirmed": True,
"localCenter": "/api/v1/local_centers/1",
"companyIdentifier": "US-123456789",
"companyName": "Civic Collective LLC",
"companyAddress": "123 Beacon Street, Boston, MA 02108",
"customFieldValues": ["/api/v1/custom_field_values/1"],
"professionOrganisationRole": "Civic Collective",
"companyRegNo": "DE-HRB-12345",
"status": "/api/v1/profile_statuses/1",
"gender": "M",
"dateBirth": "2026-01-15T10:30:00+00:00",
"personalIdNumber": "string"
}
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',
middleName: 'L.',
email: 'james.patterson@example.com',
phone: '+1 415 555 0142',
isEventAppPhonePrivate: true,
isEventAppEmailPrivate: true,
prefEventAppOnboardingSeen: true,
isEventAppProfilePublic: true,
organisation: 'Civic Collective',
role: 'ROLE_USER',
twitter: 'https://twitter.com/jpatterson',
linkedin: 'https://linkedin.com/in/james-patterson',
instagram: 'https://instagram.com/jpatterson',
bsky: '@jpatterson.bsky.social',
bio: 'Volunteer organizer in the Boston chapter since 2022.',
country: '/api/v1/countries/1',
town: '/api/v1/towns/1',
isEmailConfirmed: true,
localCenter: '/api/v1/local_centers/1',
companyIdentifier: 'US-123456789',
companyName: 'Civic Collective LLC',
companyAddress: '123 Beacon Street, Boston, MA 02108',
customFieldValues: ['/api/v1/custom_field_values/1'],
professionOrganisationRole: 'Civic Collective',
companyRegNo: 'DE-HRB-12345',
status: '/api/v1/profile_statuses/1',
gender: 'M',
dateBirth: '2026-01-15T10:30:00+00:00',
personalIdNumber: 'string'
})
};
fetch('https://app.orgo.space/api/v1/contacts/{id}/send-email', 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/contacts/{id}/send-email",
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',
'middleName' => 'L.',
'email' => 'james.patterson@example.com',
'phone' => '+1 415 555 0142',
'isEventAppPhonePrivate' => true,
'isEventAppEmailPrivate' => true,
'prefEventAppOnboardingSeen' => true,
'isEventAppProfilePublic' => true,
'organisation' => 'Civic Collective',
'role' => 'ROLE_USER',
'twitter' => 'https://twitter.com/jpatterson',
'linkedin' => 'https://linkedin.com/in/james-patterson',
'instagram' => 'https://instagram.com/jpatterson',
'bsky' => '@jpatterson.bsky.social',
'bio' => 'Volunteer organizer in the Boston chapter since 2022.',
'country' => '/api/v1/countries/1',
'town' => '/api/v1/towns/1',
'isEmailConfirmed' => true,
'localCenter' => '/api/v1/local_centers/1',
'companyIdentifier' => 'US-123456789',
'companyName' => 'Civic Collective LLC',
'companyAddress' => '123 Beacon Street, Boston, MA 02108',
'customFieldValues' => [
'/api/v1/custom_field_values/1'
],
'professionOrganisationRole' => 'Civic Collective',
'companyRegNo' => 'DE-HRB-12345',
'status' => '/api/v1/profile_statuses/1',
'gender' => 'M',
'dateBirth' => '2026-01-15T10:30:00+00:00',
'personalIdNumber' => 'string'
]),
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/contacts/{id}/send-email"
payload := strings.NewReader("{\n \"name\": \"Boston Chapter\",\n \"middleName\": \"L.\",\n \"email\": \"james.patterson@example.com\",\n \"phone\": \"+1 415 555 0142\",\n \"isEventAppPhonePrivate\": true,\n \"isEventAppEmailPrivate\": true,\n \"prefEventAppOnboardingSeen\": true,\n \"isEventAppProfilePublic\": true,\n \"organisation\": \"Civic Collective\",\n \"role\": \"ROLE_USER\",\n \"twitter\": \"https://twitter.com/jpatterson\",\n \"linkedin\": \"https://linkedin.com/in/james-patterson\",\n \"instagram\": \"https://instagram.com/jpatterson\",\n \"bsky\": \"@jpatterson.bsky.social\",\n \"bio\": \"Volunteer organizer in the Boston chapter since 2022.\",\n \"country\": \"/api/v1/countries/1\",\n \"town\": \"/api/v1/towns/1\",\n \"isEmailConfirmed\": true,\n \"localCenter\": \"/api/v1/local_centers/1\",\n \"companyIdentifier\": \"US-123456789\",\n \"companyName\": \"Civic Collective LLC\",\n \"companyAddress\": \"123 Beacon Street, Boston, MA 02108\",\n \"customFieldValues\": [\n \"/api/v1/custom_field_values/1\"\n ],\n \"professionOrganisationRole\": \"Civic Collective\",\n \"companyRegNo\": \"DE-HRB-12345\",\n \"status\": \"/api/v1/profile_statuses/1\",\n \"gender\": \"M\",\n \"dateBirth\": \"2026-01-15T10:30:00+00:00\",\n \"personalIdNumber\": \"string\"\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/contacts/{id}/send-email")
.header("Api-Token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Boston Chapter\",\n \"middleName\": \"L.\",\n \"email\": \"james.patterson@example.com\",\n \"phone\": \"+1 415 555 0142\",\n \"isEventAppPhonePrivate\": true,\n \"isEventAppEmailPrivate\": true,\n \"prefEventAppOnboardingSeen\": true,\n \"isEventAppProfilePublic\": true,\n \"organisation\": \"Civic Collective\",\n \"role\": \"ROLE_USER\",\n \"twitter\": \"https://twitter.com/jpatterson\",\n \"linkedin\": \"https://linkedin.com/in/james-patterson\",\n \"instagram\": \"https://instagram.com/jpatterson\",\n \"bsky\": \"@jpatterson.bsky.social\",\n \"bio\": \"Volunteer organizer in the Boston chapter since 2022.\",\n \"country\": \"/api/v1/countries/1\",\n \"town\": \"/api/v1/towns/1\",\n \"isEmailConfirmed\": true,\n \"localCenter\": \"/api/v1/local_centers/1\",\n \"companyIdentifier\": \"US-123456789\",\n \"companyName\": \"Civic Collective LLC\",\n \"companyAddress\": \"123 Beacon Street, Boston, MA 02108\",\n \"customFieldValues\": [\n \"/api/v1/custom_field_values/1\"\n ],\n \"professionOrganisationRole\": \"Civic Collective\",\n \"companyRegNo\": \"DE-HRB-12345\",\n \"status\": \"/api/v1/profile_statuses/1\",\n \"gender\": \"M\",\n \"dateBirth\": \"2026-01-15T10:30:00+00:00\",\n \"personalIdNumber\": \"string\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.orgo.space/api/v1/contacts/{id}/send-email")
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 \"middleName\": \"L.\",\n \"email\": \"james.patterson@example.com\",\n \"phone\": \"+1 415 555 0142\",\n \"isEventAppPhonePrivate\": true,\n \"isEventAppEmailPrivate\": true,\n \"prefEventAppOnboardingSeen\": true,\n \"isEventAppProfilePublic\": true,\n \"organisation\": \"Civic Collective\",\n \"role\": \"ROLE_USER\",\n \"twitter\": \"https://twitter.com/jpatterson\",\n \"linkedin\": \"https://linkedin.com/in/james-patterson\",\n \"instagram\": \"https://instagram.com/jpatterson\",\n \"bsky\": \"@jpatterson.bsky.social\",\n \"bio\": \"Volunteer organizer in the Boston chapter since 2022.\",\n \"country\": \"/api/v1/countries/1\",\n \"town\": \"/api/v1/towns/1\",\n \"isEmailConfirmed\": true,\n \"localCenter\": \"/api/v1/local_centers/1\",\n \"companyIdentifier\": \"US-123456789\",\n \"companyName\": \"Civic Collective LLC\",\n \"companyAddress\": \"123 Beacon Street, Boston, MA 02108\",\n \"customFieldValues\": [\n \"/api/v1/custom_field_values/1\"\n ],\n \"professionOrganisationRole\": \"Civic Collective\",\n \"companyRegNo\": \"DE-HRB-12345\",\n \"status\": \"/api/v1/profile_statuses/1\",\n \"gender\": \"M\",\n \"dateBirth\": \"2026-01-15T10:30:00+00:00\",\n \"personalIdNumber\": \"string\"\n}"
response = http.request(request)
puts response.read_body{
"id": 42,
"name": "Boston Chapter",
"middleName": "L.",
"email": "james.patterson@example.com",
"phone": "+1 415 555 0142",
"isEventAppPhonePrivate": true,
"isEventAppEmailPrivate": true,
"prefEventAppOnboardingSeen": true,
"isEventAppProfilePublic": true,
"organisation": "Civic Collective",
"role": "ROLE_USER",
"twitter": "https://twitter.com/jpatterson",
"linkedin": "https://linkedin.com/in/james-patterson",
"instagram": "https://instagram.com/jpatterson",
"bsky": "@jpatterson.bsky.social",
"logo": "https://cdn.orgo.space/tenants/acme/logo.png",
"bio": "Volunteer organizer in the Boston chapter since 2022.",
"country": {
"id": 42,
"name": "Boston Chapter"
},
"isNewsletterSubscribed": true,
"stripeCustomerId": "cus_NhpBuxIyR4Qbpd",
"town": {
"id": 42,
"name": "Boston Chapter",
"country": {
"id": 42,
"name": "Boston Chapter"
}
},
"dateCreated": "2026-01-15T10:30:00+00:00",
"isValidatedIdentity": true,
"isValidatedIdentityPending": true,
"identity": {
"id": 42,
"isValidated": true,
"hasUploadedDocument": true,
"idAddress": "123 Beacon Street, Boston, MA 02108",
"status": "ACTIVE",
"addressStreet": "123 Beacon Street, Boston, MA 02108",
"addressDetails": "123 Beacon Street, Boston, MA 02108"
},
"isEmailConfirmed": true,
"localCenter": {
"id": 42,
"name": "Boston Chapter"
},
"product": "/api/v1/products/1",
"companyIdentifier": "US-123456789",
"companyName": "Civic Collective LLC",
"companyAddress": "123 Beacon Street, Boston, MA 02108",
"customFieldValues": [
{
"id": 42,
"field": {
"id": 42,
"name": "Boston Chapter",
"fieldType": "string"
},
"value": "Vegetarian",
"media": {
"id": 42,
"size": 42,
"contentUrl": "https://civic-collective.example.com",
"mimeType": "application/pdf",
"originalName": "Boston Chapter"
},
"dateCreated": "2026-01-15T10:30:00+00:00"
}
],
"professionOrganisationRole": "Civic Collective",
"companyRegNo": "DE-HRB-12345",
"status": {
"id": 42,
"name": "Boston Chapter",
"color": "#16A34A",
"position": 42
},
"lastStatusUpdate": "2026-01-15T10:30:00+00:00",
"tags": [
{
"id": 42,
"tag": {
"id": 42,
"name": "Boston Chapter"
},
"createdAt": "2026-01-15T10:30:00+00:00"
}
],
"contactNotes": [
{
"uuid": "01938d8e-9c4f-7c2a-b8e1-3f7a9b8c4f12",
"text": "Hello, you're invited to the Annual General Meeting.",
"action": "string",
"dateCreated": "2026-01-15T10:30:00+00:00",
"dateUpdated": "2026-01-15T10:30:00+00:00",
"authorName": "Boston Chapter",
"authorId": 42,
"authorLogo": "https://cdn.orgo.space/tenants/acme/logo.png"
}
],
"gender": "M",
"dateBirth": "2026-01-15T10:30:00+00:00",
"source": "string",
"fullName": "James Patterson",
"firstName": "James",
"lastName": "Patterson",
"age": 34,
"hasPersonalIdNumber": true
}Authorizations
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.
Path Parameters
Contact identifier
Body
The new Contact resource
"/api/v1/countries/1"
"/api/v1/towns/1"
"/api/v1/local_centers/1"
["/api/v1/custom_field_values/1"]
"/api/v1/profile_statuses/1"
Response
Contact resource created
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
"/api/v1/products/1"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes

