curl --request POST \
--url https://app.orgo.space/api/v1/invoices \
--header 'Api-Token: <api-key>' \
--header 'Content-Type: application/json' \
--data @- <<EOF
{
"user": "/api/v1/users/1",
"contact": "/api/v1/contacts/1",
"company": "/api/v1/companies/1",
"amount": 50,
"invoicedFor": "string",
"type": "MEMBER",
"body": "<p>Hello {{firstName}},</p><p>You're invited.</p>",
"createdBy": "/api/v1/users/1",
"internalNotes": "Joined via the Boston outreach drive on 2026-01-10.",
"invoiceDate": "2026-01-15T10:30:00+00:00",
"membershipStartDate": "2026-01-15T10:30:00+00:00",
"membershipEndDate": "2026-01-15T10:30:00+00:00",
"isMembership": true,
"membershipProductPrice": "/api/v1/product_prices/1",
"invoiceDueDate": "2026-01-15T10:30:00+00:00",
"quantity": 42,
"taxValue": 42,
"taxName": "Boston Chapter",
"memo": "string",
"footer": "string",
"customFields": [
"string"
],
"billingName": "Boston Chapter",
"billingAddress": "123 Beacon Street, Boston, MA 02108",
"billingRegistrationNumber": "string",
"billingVatNumber": "US123456789",
"billingEmail": "james.patterson@example.com",
"billingPhone": "+1 415 555 0142",
"billingPhoneCountry": "+1 415 555 0142"
}
EOFimport requests
url = "https://app.orgo.space/api/v1/invoices"
payload = {
"user": "/api/v1/users/1",
"contact": "/api/v1/contacts/1",
"company": "/api/v1/companies/1",
"amount": 50,
"invoicedFor": "string",
"type": "MEMBER",
"body": "<p>Hello {{firstName}},</p><p>You're invited.</p>",
"createdBy": "/api/v1/users/1",
"internalNotes": "Joined via the Boston outreach drive on 2026-01-10.",
"invoiceDate": "2026-01-15T10:30:00+00:00",
"membershipStartDate": "2026-01-15T10:30:00+00:00",
"membershipEndDate": "2026-01-15T10:30:00+00:00",
"isMembership": True,
"membershipProductPrice": "/api/v1/product_prices/1",
"invoiceDueDate": "2026-01-15T10:30:00+00:00",
"quantity": 42,
"taxValue": 42,
"taxName": "Boston Chapter",
"memo": "string",
"footer": "string",
"customFields": ["string"],
"billingName": "Boston Chapter",
"billingAddress": "123 Beacon Street, Boston, MA 02108",
"billingRegistrationNumber": "string",
"billingVatNumber": "US123456789",
"billingEmail": "james.patterson@example.com",
"billingPhone": "+1 415 555 0142",
"billingPhoneCountry": "+1 415 555 0142"
}
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({
user: '/api/v1/users/1',
contact: '/api/v1/contacts/1',
company: '/api/v1/companies/1',
amount: 50,
invoicedFor: 'string',
type: 'MEMBER',
body: JSON.stringify('<p>Hello {{firstName}},</p><p>You\'re invited.</p>'),
createdBy: '/api/v1/users/1',
internalNotes: 'Joined via the Boston outreach drive on 2026-01-10.',
invoiceDate: '2026-01-15T10:30:00+00:00',
membershipStartDate: '2026-01-15T10:30:00+00:00',
membershipEndDate: '2026-01-15T10:30:00+00:00',
isMembership: true,
membershipProductPrice: '/api/v1/product_prices/1',
invoiceDueDate: '2026-01-15T10:30:00+00:00',
quantity: 42,
taxValue: 42,
taxName: 'Boston Chapter',
memo: 'string',
footer: 'string',
customFields: ['string'],
billingName: 'Boston Chapter',
billingAddress: '123 Beacon Street, Boston, MA 02108',
billingRegistrationNumber: 'string',
billingVatNumber: 'US123456789',
billingEmail: 'james.patterson@example.com',
billingPhone: '+1 415 555 0142',
billingPhoneCountry: '+1 415 555 0142'
})
};
fetch('https://app.orgo.space/api/v1/invoices', 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/invoices",
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([
'user' => '/api/v1/users/1',
'contact' => '/api/v1/contacts/1',
'company' => '/api/v1/companies/1',
'amount' => 50,
'invoicedFor' => 'string',
'type' => 'MEMBER',
'body' => '<p>Hello {{firstName}},</p><p>You\'re invited.</p>',
'createdBy' => '/api/v1/users/1',
'internalNotes' => 'Joined via the Boston outreach drive on 2026-01-10.',
'invoiceDate' => '2026-01-15T10:30:00+00:00',
'membershipStartDate' => '2026-01-15T10:30:00+00:00',
'membershipEndDate' => '2026-01-15T10:30:00+00:00',
'isMembership' => true,
'membershipProductPrice' => '/api/v1/product_prices/1',
'invoiceDueDate' => '2026-01-15T10:30:00+00:00',
'quantity' => 42,
'taxValue' => 42,
'taxName' => 'Boston Chapter',
'memo' => 'string',
'footer' => 'string',
'customFields' => [
'string'
],
'billingName' => 'Boston Chapter',
'billingAddress' => '123 Beacon Street, Boston, MA 02108',
'billingRegistrationNumber' => 'string',
'billingVatNumber' => 'US123456789',
'billingEmail' => 'james.patterson@example.com',
'billingPhone' => '+1 415 555 0142',
'billingPhoneCountry' => '+1 415 555 0142'
]),
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/invoices"
payload := strings.NewReader("{\n \"user\": \"/api/v1/users/1\",\n \"contact\": \"/api/v1/contacts/1\",\n \"company\": \"/api/v1/companies/1\",\n \"amount\": 50,\n \"invoicedFor\": \"string\",\n \"type\": \"MEMBER\",\n \"body\": \"<p>Hello {{firstName}},</p><p>You're invited.</p>\",\n \"createdBy\": \"/api/v1/users/1\",\n \"internalNotes\": \"Joined via the Boston outreach drive on 2026-01-10.\",\n \"invoiceDate\": \"2026-01-15T10:30:00+00:00\",\n \"membershipStartDate\": \"2026-01-15T10:30:00+00:00\",\n \"membershipEndDate\": \"2026-01-15T10:30:00+00:00\",\n \"isMembership\": true,\n \"membershipProductPrice\": \"/api/v1/product_prices/1\",\n \"invoiceDueDate\": \"2026-01-15T10:30:00+00:00\",\n \"quantity\": 42,\n \"taxValue\": 42,\n \"taxName\": \"Boston Chapter\",\n \"memo\": \"string\",\n \"footer\": \"string\",\n \"customFields\": [\n \"string\"\n ],\n \"billingName\": \"Boston Chapter\",\n \"billingAddress\": \"123 Beacon Street, Boston, MA 02108\",\n \"billingRegistrationNumber\": \"string\",\n \"billingVatNumber\": \"US123456789\",\n \"billingEmail\": \"james.patterson@example.com\",\n \"billingPhone\": \"+1 415 555 0142\",\n \"billingPhoneCountry\": \"+1 415 555 0142\"\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/invoices")
.header("Api-Token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"user\": \"/api/v1/users/1\",\n \"contact\": \"/api/v1/contacts/1\",\n \"company\": \"/api/v1/companies/1\",\n \"amount\": 50,\n \"invoicedFor\": \"string\",\n \"type\": \"MEMBER\",\n \"body\": \"<p>Hello {{firstName}},</p><p>You're invited.</p>\",\n \"createdBy\": \"/api/v1/users/1\",\n \"internalNotes\": \"Joined via the Boston outreach drive on 2026-01-10.\",\n \"invoiceDate\": \"2026-01-15T10:30:00+00:00\",\n \"membershipStartDate\": \"2026-01-15T10:30:00+00:00\",\n \"membershipEndDate\": \"2026-01-15T10:30:00+00:00\",\n \"isMembership\": true,\n \"membershipProductPrice\": \"/api/v1/product_prices/1\",\n \"invoiceDueDate\": \"2026-01-15T10:30:00+00:00\",\n \"quantity\": 42,\n \"taxValue\": 42,\n \"taxName\": \"Boston Chapter\",\n \"memo\": \"string\",\n \"footer\": \"string\",\n \"customFields\": [\n \"string\"\n ],\n \"billingName\": \"Boston Chapter\",\n \"billingAddress\": \"123 Beacon Street, Boston, MA 02108\",\n \"billingRegistrationNumber\": \"string\",\n \"billingVatNumber\": \"US123456789\",\n \"billingEmail\": \"james.patterson@example.com\",\n \"billingPhone\": \"+1 415 555 0142\",\n \"billingPhoneCountry\": \"+1 415 555 0142\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.orgo.space/api/v1/invoices")
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 \"user\": \"/api/v1/users/1\",\n \"contact\": \"/api/v1/contacts/1\",\n \"company\": \"/api/v1/companies/1\",\n \"amount\": 50,\n \"invoicedFor\": \"string\",\n \"type\": \"MEMBER\",\n \"body\": \"<p>Hello {{firstName}},</p><p>You're invited.</p>\",\n \"createdBy\": \"/api/v1/users/1\",\n \"internalNotes\": \"Joined via the Boston outreach drive on 2026-01-10.\",\n \"invoiceDate\": \"2026-01-15T10:30:00+00:00\",\n \"membershipStartDate\": \"2026-01-15T10:30:00+00:00\",\n \"membershipEndDate\": \"2026-01-15T10:30:00+00:00\",\n \"isMembership\": true,\n \"membershipProductPrice\": \"/api/v1/product_prices/1\",\n \"invoiceDueDate\": \"2026-01-15T10:30:00+00:00\",\n \"quantity\": 42,\n \"taxValue\": 42,\n \"taxName\": \"Boston Chapter\",\n \"memo\": \"string\",\n \"footer\": \"string\",\n \"customFields\": [\n \"string\"\n ],\n \"billingName\": \"Boston Chapter\",\n \"billingAddress\": \"123 Beacon Street, Boston, MA 02108\",\n \"billingRegistrationNumber\": \"string\",\n \"billingVatNumber\": \"US123456789\",\n \"billingEmail\": \"james.patterson@example.com\",\n \"billingPhone\": \"+1 415 555 0142\",\n \"billingPhoneCountry\": \"+1 415 555 0142\"\n}"
response = http.request(request)
puts response.read_body{
"id": 42,
"invoiceNumber": 42,
"user": {
"id": 42,
"firstName": "James",
"lastName": "Patterson",
"email": "james.patterson@example.com",
"fullName": "James Patterson",
"companyIdentifier": "US-123456789",
"companyName": "Civic Collective LLC",
"companyAddress": "123 Beacon Street, Boston, MA 02108",
"companyRegNo": "DE-HRB-12345"
},
"contact": {
"id": 42,
"name": "Boston Chapter",
"email": "james.patterson@example.com",
"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",
"lastStatusUpdate": "2026-01-15T10:30:00+00:00",
"fullName": "James Patterson",
"firstName": "James",
"lastName": "Patterson"
},
"company": {
"uuid": "01938d8e-9c4f-7c2a-b8e1-3f7a9b8c4f12",
"name": "Boston Chapter",
"legalName": "Boston Chapter"
},
"amount": 50,
"invoicedFor": "string",
"type": "MEMBER",
"body": "<p>Hello {{firstName}},</p><p>You're invited.</p>",
"status": "ACTIVE",
"internalNotes": "Joined via the Boston outreach drive on 2026-01-10.",
"dateCreated": "2026-01-15T10:30:00+00:00",
"dateUpdated": "2026-01-15T10:30:00+00:00",
"invoiceDate": "2026-01-15T10:30:00+00:00",
"dateRefunded": "2026-01-15T10:30:00+00:00",
"refundedBy": {
"id": 42,
"firstName": "James",
"lastName": "Patterson",
"email": "james.patterson@example.com",
"fullName": "James Patterson",
"companyIdentifier": "US-123456789",
"companyName": "Civic Collective LLC",
"companyAddress": "123 Beacon Street, Boston, MA 02108",
"companyRegNo": "DE-HRB-12345"
},
"membershipStartDate": "2026-01-15T10:30:00+00:00",
"membershipEndDate": "2026-01-15T10:30:00+00:00",
"isMembership": true,
"membershipProductPrice": "/api/v1/product_prices/1",
"series": "string",
"invoiceDueDate": "2026-01-15T10:30:00+00:00",
"quantity": 42,
"taxValue": 42,
"taxName": "Boston Chapter",
"memo": "string",
"footer": "string",
"customFields": [
"string"
],
"billingName": "Boston Chapter",
"billingAddress": "123 Beacon Street, Boston, MA 02108",
"billingRegistrationNumber": "string",
"billingVatNumber": "US123456789",
"billingEmail": "james.patterson@example.com",
"billingPhone": "+1 415 555 0142",
"billingPhoneCountry": "+1 415 555 0142",
"unitPrice": 50,
"subtotal": 50,
"taxAmount": 50,
"totalWithTax": 50
}Create an invoice
Creates a manual invoice with auto-generated invoice number and hash. Sets status to unpaid and type to manual. Validates membership status if applicable. Generates the HTML body from the invoice template with placeholders replaced, builds the request payload for payment links, and automatically sends the invoice email to the recipient. Requires ADMIN_TENANT permission.
curl --request POST \
--url https://app.orgo.space/api/v1/invoices \
--header 'Api-Token: <api-key>' \
--header 'Content-Type: application/json' \
--data @- <<EOF
{
"user": "/api/v1/users/1",
"contact": "/api/v1/contacts/1",
"company": "/api/v1/companies/1",
"amount": 50,
"invoicedFor": "string",
"type": "MEMBER",
"body": "<p>Hello {{firstName}},</p><p>You're invited.</p>",
"createdBy": "/api/v1/users/1",
"internalNotes": "Joined via the Boston outreach drive on 2026-01-10.",
"invoiceDate": "2026-01-15T10:30:00+00:00",
"membershipStartDate": "2026-01-15T10:30:00+00:00",
"membershipEndDate": "2026-01-15T10:30:00+00:00",
"isMembership": true,
"membershipProductPrice": "/api/v1/product_prices/1",
"invoiceDueDate": "2026-01-15T10:30:00+00:00",
"quantity": 42,
"taxValue": 42,
"taxName": "Boston Chapter",
"memo": "string",
"footer": "string",
"customFields": [
"string"
],
"billingName": "Boston Chapter",
"billingAddress": "123 Beacon Street, Boston, MA 02108",
"billingRegistrationNumber": "string",
"billingVatNumber": "US123456789",
"billingEmail": "james.patterson@example.com",
"billingPhone": "+1 415 555 0142",
"billingPhoneCountry": "+1 415 555 0142"
}
EOFimport requests
url = "https://app.orgo.space/api/v1/invoices"
payload = {
"user": "/api/v1/users/1",
"contact": "/api/v1/contacts/1",
"company": "/api/v1/companies/1",
"amount": 50,
"invoicedFor": "string",
"type": "MEMBER",
"body": "<p>Hello {{firstName}},</p><p>You're invited.</p>",
"createdBy": "/api/v1/users/1",
"internalNotes": "Joined via the Boston outreach drive on 2026-01-10.",
"invoiceDate": "2026-01-15T10:30:00+00:00",
"membershipStartDate": "2026-01-15T10:30:00+00:00",
"membershipEndDate": "2026-01-15T10:30:00+00:00",
"isMembership": True,
"membershipProductPrice": "/api/v1/product_prices/1",
"invoiceDueDate": "2026-01-15T10:30:00+00:00",
"quantity": 42,
"taxValue": 42,
"taxName": "Boston Chapter",
"memo": "string",
"footer": "string",
"customFields": ["string"],
"billingName": "Boston Chapter",
"billingAddress": "123 Beacon Street, Boston, MA 02108",
"billingRegistrationNumber": "string",
"billingVatNumber": "US123456789",
"billingEmail": "james.patterson@example.com",
"billingPhone": "+1 415 555 0142",
"billingPhoneCountry": "+1 415 555 0142"
}
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({
user: '/api/v1/users/1',
contact: '/api/v1/contacts/1',
company: '/api/v1/companies/1',
amount: 50,
invoicedFor: 'string',
type: 'MEMBER',
body: JSON.stringify('<p>Hello {{firstName}},</p><p>You\'re invited.</p>'),
createdBy: '/api/v1/users/1',
internalNotes: 'Joined via the Boston outreach drive on 2026-01-10.',
invoiceDate: '2026-01-15T10:30:00+00:00',
membershipStartDate: '2026-01-15T10:30:00+00:00',
membershipEndDate: '2026-01-15T10:30:00+00:00',
isMembership: true,
membershipProductPrice: '/api/v1/product_prices/1',
invoiceDueDate: '2026-01-15T10:30:00+00:00',
quantity: 42,
taxValue: 42,
taxName: 'Boston Chapter',
memo: 'string',
footer: 'string',
customFields: ['string'],
billingName: 'Boston Chapter',
billingAddress: '123 Beacon Street, Boston, MA 02108',
billingRegistrationNumber: 'string',
billingVatNumber: 'US123456789',
billingEmail: 'james.patterson@example.com',
billingPhone: '+1 415 555 0142',
billingPhoneCountry: '+1 415 555 0142'
})
};
fetch('https://app.orgo.space/api/v1/invoices', 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/invoices",
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([
'user' => '/api/v1/users/1',
'contact' => '/api/v1/contacts/1',
'company' => '/api/v1/companies/1',
'amount' => 50,
'invoicedFor' => 'string',
'type' => 'MEMBER',
'body' => '<p>Hello {{firstName}},</p><p>You\'re invited.</p>',
'createdBy' => '/api/v1/users/1',
'internalNotes' => 'Joined via the Boston outreach drive on 2026-01-10.',
'invoiceDate' => '2026-01-15T10:30:00+00:00',
'membershipStartDate' => '2026-01-15T10:30:00+00:00',
'membershipEndDate' => '2026-01-15T10:30:00+00:00',
'isMembership' => true,
'membershipProductPrice' => '/api/v1/product_prices/1',
'invoiceDueDate' => '2026-01-15T10:30:00+00:00',
'quantity' => 42,
'taxValue' => 42,
'taxName' => 'Boston Chapter',
'memo' => 'string',
'footer' => 'string',
'customFields' => [
'string'
],
'billingName' => 'Boston Chapter',
'billingAddress' => '123 Beacon Street, Boston, MA 02108',
'billingRegistrationNumber' => 'string',
'billingVatNumber' => 'US123456789',
'billingEmail' => 'james.patterson@example.com',
'billingPhone' => '+1 415 555 0142',
'billingPhoneCountry' => '+1 415 555 0142'
]),
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/invoices"
payload := strings.NewReader("{\n \"user\": \"/api/v1/users/1\",\n \"contact\": \"/api/v1/contacts/1\",\n \"company\": \"/api/v1/companies/1\",\n \"amount\": 50,\n \"invoicedFor\": \"string\",\n \"type\": \"MEMBER\",\n \"body\": \"<p>Hello {{firstName}},</p><p>You're invited.</p>\",\n \"createdBy\": \"/api/v1/users/1\",\n \"internalNotes\": \"Joined via the Boston outreach drive on 2026-01-10.\",\n \"invoiceDate\": \"2026-01-15T10:30:00+00:00\",\n \"membershipStartDate\": \"2026-01-15T10:30:00+00:00\",\n \"membershipEndDate\": \"2026-01-15T10:30:00+00:00\",\n \"isMembership\": true,\n \"membershipProductPrice\": \"/api/v1/product_prices/1\",\n \"invoiceDueDate\": \"2026-01-15T10:30:00+00:00\",\n \"quantity\": 42,\n \"taxValue\": 42,\n \"taxName\": \"Boston Chapter\",\n \"memo\": \"string\",\n \"footer\": \"string\",\n \"customFields\": [\n \"string\"\n ],\n \"billingName\": \"Boston Chapter\",\n \"billingAddress\": \"123 Beacon Street, Boston, MA 02108\",\n \"billingRegistrationNumber\": \"string\",\n \"billingVatNumber\": \"US123456789\",\n \"billingEmail\": \"james.patterson@example.com\",\n \"billingPhone\": \"+1 415 555 0142\",\n \"billingPhoneCountry\": \"+1 415 555 0142\"\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/invoices")
.header("Api-Token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"user\": \"/api/v1/users/1\",\n \"contact\": \"/api/v1/contacts/1\",\n \"company\": \"/api/v1/companies/1\",\n \"amount\": 50,\n \"invoicedFor\": \"string\",\n \"type\": \"MEMBER\",\n \"body\": \"<p>Hello {{firstName}},</p><p>You're invited.</p>\",\n \"createdBy\": \"/api/v1/users/1\",\n \"internalNotes\": \"Joined via the Boston outreach drive on 2026-01-10.\",\n \"invoiceDate\": \"2026-01-15T10:30:00+00:00\",\n \"membershipStartDate\": \"2026-01-15T10:30:00+00:00\",\n \"membershipEndDate\": \"2026-01-15T10:30:00+00:00\",\n \"isMembership\": true,\n \"membershipProductPrice\": \"/api/v1/product_prices/1\",\n \"invoiceDueDate\": \"2026-01-15T10:30:00+00:00\",\n \"quantity\": 42,\n \"taxValue\": 42,\n \"taxName\": \"Boston Chapter\",\n \"memo\": \"string\",\n \"footer\": \"string\",\n \"customFields\": [\n \"string\"\n ],\n \"billingName\": \"Boston Chapter\",\n \"billingAddress\": \"123 Beacon Street, Boston, MA 02108\",\n \"billingRegistrationNumber\": \"string\",\n \"billingVatNumber\": \"US123456789\",\n \"billingEmail\": \"james.patterson@example.com\",\n \"billingPhone\": \"+1 415 555 0142\",\n \"billingPhoneCountry\": \"+1 415 555 0142\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.orgo.space/api/v1/invoices")
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 \"user\": \"/api/v1/users/1\",\n \"contact\": \"/api/v1/contacts/1\",\n \"company\": \"/api/v1/companies/1\",\n \"amount\": 50,\n \"invoicedFor\": \"string\",\n \"type\": \"MEMBER\",\n \"body\": \"<p>Hello {{firstName}},</p><p>You're invited.</p>\",\n \"createdBy\": \"/api/v1/users/1\",\n \"internalNotes\": \"Joined via the Boston outreach drive on 2026-01-10.\",\n \"invoiceDate\": \"2026-01-15T10:30:00+00:00\",\n \"membershipStartDate\": \"2026-01-15T10:30:00+00:00\",\n \"membershipEndDate\": \"2026-01-15T10:30:00+00:00\",\n \"isMembership\": true,\n \"membershipProductPrice\": \"/api/v1/product_prices/1\",\n \"invoiceDueDate\": \"2026-01-15T10:30:00+00:00\",\n \"quantity\": 42,\n \"taxValue\": 42,\n \"taxName\": \"Boston Chapter\",\n \"memo\": \"string\",\n \"footer\": \"string\",\n \"customFields\": [\n \"string\"\n ],\n \"billingName\": \"Boston Chapter\",\n \"billingAddress\": \"123 Beacon Street, Boston, MA 02108\",\n \"billingRegistrationNumber\": \"string\",\n \"billingVatNumber\": \"US123456789\",\n \"billingEmail\": \"james.patterson@example.com\",\n \"billingPhone\": \"+1 415 555 0142\",\n \"billingPhoneCountry\": \"+1 415 555 0142\"\n}"
response = http.request(request)
puts response.read_body{
"id": 42,
"invoiceNumber": 42,
"user": {
"id": 42,
"firstName": "James",
"lastName": "Patterson",
"email": "james.patterson@example.com",
"fullName": "James Patterson",
"companyIdentifier": "US-123456789",
"companyName": "Civic Collective LLC",
"companyAddress": "123 Beacon Street, Boston, MA 02108",
"companyRegNo": "DE-HRB-12345"
},
"contact": {
"id": 42,
"name": "Boston Chapter",
"email": "james.patterson@example.com",
"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",
"lastStatusUpdate": "2026-01-15T10:30:00+00:00",
"fullName": "James Patterson",
"firstName": "James",
"lastName": "Patterson"
},
"company": {
"uuid": "01938d8e-9c4f-7c2a-b8e1-3f7a9b8c4f12",
"name": "Boston Chapter",
"legalName": "Boston Chapter"
},
"amount": 50,
"invoicedFor": "string",
"type": "MEMBER",
"body": "<p>Hello {{firstName}},</p><p>You're invited.</p>",
"status": "ACTIVE",
"internalNotes": "Joined via the Boston outreach drive on 2026-01-10.",
"dateCreated": "2026-01-15T10:30:00+00:00",
"dateUpdated": "2026-01-15T10:30:00+00:00",
"invoiceDate": "2026-01-15T10:30:00+00:00",
"dateRefunded": "2026-01-15T10:30:00+00:00",
"refundedBy": {
"id": 42,
"firstName": "James",
"lastName": "Patterson",
"email": "james.patterson@example.com",
"fullName": "James Patterson",
"companyIdentifier": "US-123456789",
"companyName": "Civic Collective LLC",
"companyAddress": "123 Beacon Street, Boston, MA 02108",
"companyRegNo": "DE-HRB-12345"
},
"membershipStartDate": "2026-01-15T10:30:00+00:00",
"membershipEndDate": "2026-01-15T10:30:00+00:00",
"isMembership": true,
"membershipProductPrice": "/api/v1/product_prices/1",
"series": "string",
"invoiceDueDate": "2026-01-15T10:30:00+00:00",
"quantity": 42,
"taxValue": 42,
"taxName": "Boston Chapter",
"memo": "string",
"footer": "string",
"customFields": [
"string"
],
"billingName": "Boston Chapter",
"billingAddress": "123 Beacon Street, Boston, MA 02108",
"billingRegistrationNumber": "string",
"billingVatNumber": "US123456789",
"billingEmail": "james.patterson@example.com",
"billingPhone": "+1 415 555 0142",
"billingPhoneCountry": "+1 415 555 0142",
"unitPrice": 50,
"subtotal": 50,
"taxAmount": 50,
"totalWithTax": 50
}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.
Body
The new Invoice resource
"/api/v1/users/1"
"/api/v1/contacts/1"
"/api/v1/companies/1"
"/api/v1/users/1"
"/api/v1/product_prices/1"
Response
Invoice 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/product_prices/1"

