Create Organization

POST

organizations

Create Organization

curl --request POST \
  --url https://api.getruba.com/v1/organizations/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "slug": "<string>",
  "avatar_url": "<string>",
  "legal_entity": {
    "type": "<string>"
  },
  "email": "jsmith@example.com",
  "website": "<string>",
  "socials": [
    {
      "url": "<string>"
    }
  ],
  "details": {
    "about": "<string>",
    "product_description": "<string>",
    "selling_categories": [
      "<string>"
    ],
    "pricing_models": [
      "<string>"
    ],
    "intended_use": "<string>",
    "customer_acquisition": [
      "<string>"
    ],
    "future_annual_revenue": 1,
    "switching": false,
    "previous_annual_revenue": 1
  },
  "feature_settings": {
    "seat_based_pricing_enabled": false,
    "member_model_enabled": false,
    "checkout_localization_enabled": false,
    "overview_metrics": [
      "<string>"
    ]
  },
  "subscription_settings": {
    "allow_multiple_subscriptions": true,
    "benefit_revocation_grace_period": 123,
    "prevent_trial_abuse": true,
    "allow_customer_updates": true
  },
  "customer_email_settings": {
    "order_confirmation": true,
    "subscription_cancellation": true,
    "subscription_confirmation": true,
    "subscription_cycled": true,
    "subscription_cycled_after_trial": true,
    "subscription_past_due": true,
    "subscription_renewal_reminder": true,
    "subscription_revoked": true,
    "subscription_trial_conversion_reminder": true,
    "subscription_uncanceled": true,
    "subscription_updated": true
  },
  "customer_portal_settings": {
    "usage": {
      "show": true
    },
    "subscription": {
      "update_seats": true,
      "update_plan": true
    },
    "customer": {
      "allow_email_change": true
    }
  },
  "default_presentment_currency": "usd",
  "default_tax_behavior": "location"
}
'

import requests

url = "https://api.getruba.com/v1/organizations/"

payload = {
    "name": "<string>",
    "slug": "<string>",
    "avatar_url": "<string>",
    "legal_entity": { "type": "<string>" },
    "email": "jsmith@example.com",
    "website": "<string>",
    "socials": [{ "url": "<string>" }],
    "details": {
        "about": "<string>",
        "product_description": "<string>",
        "selling_categories": ["<string>"],
        "pricing_models": ["<string>"],
        "intended_use": "<string>",
        "customer_acquisition": ["<string>"],
        "future_annual_revenue": 1,
        "switching": False,
        "previous_annual_revenue": 1
    },
    "feature_settings": {
        "seat_based_pricing_enabled": False,
        "member_model_enabled": False,
        "checkout_localization_enabled": False,
        "overview_metrics": ["<string>"]
    },
    "subscription_settings": {
        "allow_multiple_subscriptions": True,
        "benefit_revocation_grace_period": 123,
        "prevent_trial_abuse": True,
        "allow_customer_updates": True
    },
    "customer_email_settings": {
        "order_confirmation": True,
        "subscription_cancellation": True,
        "subscription_confirmation": True,
        "subscription_cycled": True,
        "subscription_cycled_after_trial": True,
        "subscription_past_due": True,
        "subscription_renewal_reminder": True,
        "subscription_revoked": True,
        "subscription_trial_conversion_reminder": True,
        "subscription_uncanceled": True,
        "subscription_updated": True
    },
    "customer_portal_settings": {
        "usage": { "show": True },
        "subscription": {
            "update_seats": True,
            "update_plan": True
        },
        "customer": { "allow_email_change": True }
    },
    "default_presentment_currency": "usd",
    "default_tax_behavior": "location"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    slug: '<string>',
    avatar_url: '<string>',
    legal_entity: {type: '<string>'},
    email: 'jsmith@example.com',
    website: '<string>',
    socials: [{url: '<string>'}],
    details: {
      about: '<string>',
      product_description: '<string>',
      selling_categories: ['<string>'],
      pricing_models: ['<string>'],
      intended_use: '<string>',
      customer_acquisition: ['<string>'],
      future_annual_revenue: 1,
      switching: false,
      previous_annual_revenue: 1
    },
    feature_settings: {
      seat_based_pricing_enabled: false,
      member_model_enabled: false,
      checkout_localization_enabled: false,
      overview_metrics: ['<string>']
    },
    subscription_settings: {
      allow_multiple_subscriptions: true,
      benefit_revocation_grace_period: 123,
      prevent_trial_abuse: true,
      allow_customer_updates: true
    },
    customer_email_settings: {
      order_confirmation: true,
      subscription_cancellation: true,
      subscription_confirmation: true,
      subscription_cycled: true,
      subscription_cycled_after_trial: true,
      subscription_past_due: true,
      subscription_renewal_reminder: true,
      subscription_revoked: true,
      subscription_trial_conversion_reminder: true,
      subscription_uncanceled: true,
      subscription_updated: true
    },
    customer_portal_settings: {
      usage: {show: true},
      subscription: {update_seats: true, update_plan: true},
      customer: {allow_email_change: true}
    },
    default_presentment_currency: 'usd',
    default_tax_behavior: 'location'
  })
};

fetch('https://api.getruba.com/v1/organizations/', 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://api.getruba.com/v1/organizations/",
  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' => '<string>',
    'slug' => '<string>',
    'avatar_url' => '<string>',
    'legal_entity' => [
        'type' => '<string>'
    ],
    'email' => 'jsmith@example.com',
    'website' => '<string>',
    'socials' => [
        [
                'url' => '<string>'
        ]
    ],
    'details' => [
        'about' => '<string>',
        'product_description' => '<string>',
        'selling_categories' => [
                '<string>'
        ],
        'pricing_models' => [
                '<string>'
        ],
        'intended_use' => '<string>',
        'customer_acquisition' => [
                '<string>'
        ],
        'future_annual_revenue' => 1,
        'switching' => false,
        'previous_annual_revenue' => 1
    ],
    'feature_settings' => [
        'seat_based_pricing_enabled' => false,
        'member_model_enabled' => false,
        'checkout_localization_enabled' => false,
        'overview_metrics' => [
                '<string>'
        ]
    ],
    'subscription_settings' => [
        'allow_multiple_subscriptions' => true,
        'benefit_revocation_grace_period' => 123,
        'prevent_trial_abuse' => true,
        'allow_customer_updates' => true
    ],
    'customer_email_settings' => [
        'order_confirmation' => true,
        'subscription_cancellation' => true,
        'subscription_confirmation' => true,
        'subscription_cycled' => true,
        'subscription_cycled_after_trial' => true,
        'subscription_past_due' => true,
        'subscription_renewal_reminder' => true,
        'subscription_revoked' => true,
        'subscription_trial_conversion_reminder' => true,
        'subscription_uncanceled' => true,
        'subscription_updated' => true
    ],
    'customer_portal_settings' => [
        'usage' => [
                'show' => true
        ],
        'subscription' => [
                'update_seats' => true,
                'update_plan' => true
        ],
        'customer' => [
                'allow_email_change' => true
        ]
    ],
    'default_presentment_currency' => 'usd',
    'default_tax_behavior' => 'location'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "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://api.getruba.com/v1/organizations/"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"slug\": \"<string>\",\n  \"avatar_url\": \"<string>\",\n  \"legal_entity\": {\n    \"type\": \"<string>\"\n  },\n  \"email\": \"jsmith@example.com\",\n  \"website\": \"<string>\",\n  \"socials\": [\n    {\n      \"url\": \"<string>\"\n    }\n  ],\n  \"details\": {\n    \"about\": \"<string>\",\n    \"product_description\": \"<string>\",\n    \"selling_categories\": [\n      \"<string>\"\n    ],\n    \"pricing_models\": [\n      \"<string>\"\n    ],\n    \"intended_use\": \"<string>\",\n    \"customer_acquisition\": [\n      \"<string>\"\n    ],\n    \"future_annual_revenue\": 1,\n    \"switching\": false,\n    \"previous_annual_revenue\": 1\n  },\n  \"feature_settings\": {\n    \"seat_based_pricing_enabled\": false,\n    \"member_model_enabled\": false,\n    \"checkout_localization_enabled\": false,\n    \"overview_metrics\": [\n      \"<string>\"\n    ]\n  },\n  \"subscription_settings\": {\n    \"allow_multiple_subscriptions\": true,\n    \"benefit_revocation_grace_period\": 123,\n    \"prevent_trial_abuse\": true,\n    \"allow_customer_updates\": true\n  },\n  \"customer_email_settings\": {\n    \"order_confirmation\": true,\n    \"subscription_cancellation\": true,\n    \"subscription_confirmation\": true,\n    \"subscription_cycled\": true,\n    \"subscription_cycled_after_trial\": true,\n    \"subscription_past_due\": true,\n    \"subscription_renewal_reminder\": true,\n    \"subscription_revoked\": true,\n    \"subscription_trial_conversion_reminder\": true,\n    \"subscription_uncanceled\": true,\n    \"subscription_updated\": true\n  },\n  \"customer_portal_settings\": {\n    \"usage\": {\n      \"show\": true\n    },\n    \"subscription\": {\n      \"update_seats\": true,\n      \"update_plan\": true\n    },\n    \"customer\": {\n      \"allow_email_change\": true\n    }\n  },\n  \"default_presentment_currency\": \"usd\",\n  \"default_tax_behavior\": \"location\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	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://api.getruba.com/v1/organizations/")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"slug\": \"<string>\",\n  \"avatar_url\": \"<string>\",\n  \"legal_entity\": {\n    \"type\": \"<string>\"\n  },\n  \"email\": \"jsmith@example.com\",\n  \"website\": \"<string>\",\n  \"socials\": [\n    {\n      \"url\": \"<string>\"\n    }\n  ],\n  \"details\": {\n    \"about\": \"<string>\",\n    \"product_description\": \"<string>\",\n    \"selling_categories\": [\n      \"<string>\"\n    ],\n    \"pricing_models\": [\n      \"<string>\"\n    ],\n    \"intended_use\": \"<string>\",\n    \"customer_acquisition\": [\n      \"<string>\"\n    ],\n    \"future_annual_revenue\": 1,\n    \"switching\": false,\n    \"previous_annual_revenue\": 1\n  },\n  \"feature_settings\": {\n    \"seat_based_pricing_enabled\": false,\n    \"member_model_enabled\": false,\n    \"checkout_localization_enabled\": false,\n    \"overview_metrics\": [\n      \"<string>\"\n    ]\n  },\n  \"subscription_settings\": {\n    \"allow_multiple_subscriptions\": true,\n    \"benefit_revocation_grace_period\": 123,\n    \"prevent_trial_abuse\": true,\n    \"allow_customer_updates\": true\n  },\n  \"customer_email_settings\": {\n    \"order_confirmation\": true,\n    \"subscription_cancellation\": true,\n    \"subscription_confirmation\": true,\n    \"subscription_cycled\": true,\n    \"subscription_cycled_after_trial\": true,\n    \"subscription_past_due\": true,\n    \"subscription_renewal_reminder\": true,\n    \"subscription_revoked\": true,\n    \"subscription_trial_conversion_reminder\": true,\n    \"subscription_uncanceled\": true,\n    \"subscription_updated\": true\n  },\n  \"customer_portal_settings\": {\n    \"usage\": {\n      \"show\": true\n    },\n    \"subscription\": {\n      \"update_seats\": true,\n      \"update_plan\": true\n    },\n    \"customer\": {\n      \"allow_email_change\": true\n    }\n  },\n  \"default_presentment_currency\": \"usd\",\n  \"default_tax_behavior\": \"location\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.getruba.com/v1/organizations/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"slug\": \"<string>\",\n  \"avatar_url\": \"<string>\",\n  \"legal_entity\": {\n    \"type\": \"<string>\"\n  },\n  \"email\": \"jsmith@example.com\",\n  \"website\": \"<string>\",\n  \"socials\": [\n    {\n      \"url\": \"<string>\"\n    }\n  ],\n  \"details\": {\n    \"about\": \"<string>\",\n    \"product_description\": \"<string>\",\n    \"selling_categories\": [\n      \"<string>\"\n    ],\n    \"pricing_models\": [\n      \"<string>\"\n    ],\n    \"intended_use\": \"<string>\",\n    \"customer_acquisition\": [\n      \"<string>\"\n    ],\n    \"future_annual_revenue\": 1,\n    \"switching\": false,\n    \"previous_annual_revenue\": 1\n  },\n  \"feature_settings\": {\n    \"seat_based_pricing_enabled\": false,\n    \"member_model_enabled\": false,\n    \"checkout_localization_enabled\": false,\n    \"overview_metrics\": [\n      \"<string>\"\n    ]\n  },\n  \"subscription_settings\": {\n    \"allow_multiple_subscriptions\": true,\n    \"benefit_revocation_grace_period\": 123,\n    \"prevent_trial_abuse\": true,\n    \"allow_customer_updates\": true\n  },\n  \"customer_email_settings\": {\n    \"order_confirmation\": true,\n    \"subscription_cancellation\": true,\n    \"subscription_confirmation\": true,\n    \"subscription_cycled\": true,\n    \"subscription_cycled_after_trial\": true,\n    \"subscription_past_due\": true,\n    \"subscription_renewal_reminder\": true,\n    \"subscription_revoked\": true,\n    \"subscription_trial_conversion_reminder\": true,\n    \"subscription_uncanceled\": true,\n    \"subscription_updated\": true\n  },\n  \"customer_portal_settings\": {\n    \"usage\": {\n      \"show\": true\n    },\n    \"subscription\": {\n      \"update_seats\": true,\n      \"update_plan\": true\n    },\n    \"customer\": {\n      \"allow_email_change\": true\n    }\n  },\n  \"default_presentment_currency\": \"usd\",\n  \"default_tax_behavior\": \"location\"\n}"

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

{
  "created_at": "2023-11-07T05:31:56Z",
  "modified_at": "2023-11-07T05:31:56Z",
  "id": "<string>",
  "name": "<string>",
  "slug": "<string>",
  "avatar_url": "<string>",
  "allow_customer_updates": true,
  "email": "<string>",
  "website": "<string>",
  "socials": [
    {
      "url": "<string>"
    }
  ],
  "details_submitted_at": "2023-11-07T05:31:56Z",
  "default_presentment_currency": "<string>",
  "feature_settings": {
    "issue_funding_enabled": false,
    "seat_based_pricing_enabled": false,
    "wallets_enabled": false,
    "member_model_enabled": false,
    "checkout_localization_enabled": false,
    "overview_metrics": [
      "<string>"
    ],
    "reset_proration_behavior_enabled": false,
    "off_session_charges_enabled": false,
    "slack_benefit_enabled": false,
    "preview_access_enabled": false,
    "disputes_enabled": false
  },
  "subscription_settings": {
    "allow_multiple_subscriptions": true,
    "benefit_revocation_grace_period": 123,
    "prevent_trial_abuse": true,
    "allow_customer_updates": true
  },
  "customer_email_settings": {
    "order_confirmation": true,
    "subscription_cancellation": true,
    "subscription_confirmation": true,
    "subscription_cycled": true,
    "subscription_cycled_after_trial": true,
    "subscription_past_due": true,
    "subscription_renewal_reminder": true,
    "subscription_revoked": true,
    "subscription_trial_conversion_reminder": true,
    "subscription_uncanceled": true,
    "subscription_updated": true
  },
  "customer_portal_settings": {
    "usage": {
      "show": true
    },
    "subscription": {
      "update_seats": true,
      "update_plan": true
    },
    "customer": {
      "allow_email_change": true
    }
  },
  "account_id": "<string>",
  "payout_account_id": "<string>",
  "capabilities": {
    "checkout_payments": true,
    "subscription_renewals": true,
    "payouts": true,
    "refunds": true,
    "api_access": true,
    "dashboard_access": true
  }
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Authorizations

Authorization

string

header

required

Authentication: You can generate a Personal Access Token from your settings.

Body

application/json

name

string

required

Minimum string length: 3

slug

string

required

Required string length: 3 - 64

avatar_url

string<uri> | null

Required string length: 1 - 2083

legal_entity

OrganizationIndividualLegalEntitySchema · object

OrganizationIndividualLegalEntitySchema
OrganizationCompanyLegalEntitySchema

Show child attributes

string<email> | null

Email: Public support email.

website

string<uri> | null

Website: Official website of the organization.

Required string length: 1 - 2083

socials

OrganizationSocialLink · object[] | null

Socials: Link to social profiles.

Show child attributes

details

OrganizationDetails · object | null

Additional, private, business details Ruba needs about active organizations for compliance (KYC).

Show child attributes

country

enum<string> | null

Country: Two-letter country code (ISO 3166-1 alpha-2).

Available options:

AD,

AE,

AF,

AG,

AI,

AL,

AM,

AO,

AQ,

AR,

AS,

AT,

AU,

AW,

AX,

AZ,

BA,

BB,

BD,

BE,

BF,

BG,

BH,

BI,

BJ,

BL,

BM,

BN,

BO,

BQ,

BR,

BS,

BT,

BV,

BW,

BY,

BZ,

CA,

CC,

CD,

CF,

CG,

CH,

CI,

CK,

CL,

CM,

CN,

CO,

CR,

CV,

CW,

CX,

CY,

CZ,

DE,

DJ,

DK,

DM,

DO,

DZ,

EC,

EE,

EG,

EH,

ER,

ES,

ET,

FI,

FJ,

FK,

FM,

FO,

FR,

GA,

GB,

GD,

GE,

GF,

GG,

GH,

GI,

GL,

GM,

GN,

GP,

GQ,

GR,

GS,

GT,

GU,

GW,

GY,

HK,

HM,

HN,

HR,

HT,

HU,

ID,

IE,

IL,

IM,

IN,

IO,

IQ,

IS,

IT,

JE,

JM,

JO,

JP,

KE,

KG,

KH,

KI,

KM,

KN,

KR,

KW,

KY,

KZ,

LA,

LB,

LC,

LI,

LK,

LR,

LS,

LT,

LU,

LV,

LY,

MA,

MC,

MD,

ME,

MF,

MG,

MH,

MK,

ML,

MM,

MN,

MO,

MP,

MQ,

MR,

MS,

MT,

MU,

MV,

MW,

MX,

MY,

MZ,

NA,

NC,

NE,

NF,

NG,

NI,

NL,

NO,

NP,

NR,

NU,

NZ,

OM,

PA,

PE,

PF,

PG,

PH,

PK,

PL,

PM,

PN,

PR,

PS,

PT,

PW,

PY,

QA,

RE,

RO,

RS,

RW,

SA,

SB,

SC,

SD,

SE,

SG,

SH,

SI,

SJ,

SK,

SL,

SM,

SN,

SO,

SR,

SS,

ST,

SV,

SX,

SZ,

TC,

TD,

TF,

TG,

TH,

TJ,

TK,

TL,

TM,

TN,

TO,

TR,

TT,

TV,

TW,

TZ,

UA,

UG,

UM,

US,

UY,

UZ,

VA,

VC,

VE,

VG,

VI,

VN,

VU,

WF,

WS,

YE,

YT,

ZA,

ZM,

ZW

feature_settings

OrganizationFeatureSettingsUpdate · object | null

Feature settings that organizations can update themselves.

Other feature settings are managed by Ruba staff: they're ignored if provided and keep their current value.

Show child attributes

subscription_settings

OrganizationSubscriptionSettings · object | null

Show child attributes

customer_email_settings

OrganizationCustomerEmailSettings · object | null

Show child attributes

customer_portal_settings

OrganizationCustomerPortalSettings · object | null

Show child attributes

default_presentment_currency

enum<string>

default:usd

Default Presentment Currency: Default presentment currency for the organization.

Available options:

aed,

all,

amd,

aoa,

ars,

aud,

awg,

azn,

bam,

bbd,

bdt,

bif,

bmd,

bnd,

bob,

brl,

bsd,

bwp,

bzd,

cad,

cdf,

chf,

clp,

cny,

cop,

crc,

cve,

czk,

djf,

dkk,

dop,

dzd,

egp,

etb,

eur,

fjd,

fkp,

gbp,

gel,

gip,

gmd,

gnf,

gtq,

gyd,

hkd,

hnl,

htg,

huf,

idr,

ils,

inr,

isk,

jmd,

jpy,

kes,

kgs,

khr,

kmf,

krw,

kyd,

kzt,

lak,

lkr,

lrd,

lsl,

mad,

mdl,

mga,

mkd,

mnt,

mop,

mur,

mvr,

mwk,

mxn,

myr,

mzn,

nad,

ngn,

nio,

nok,

npr,

nzd,

pab,

pen,

pgk,

php,

pkr,

pln,

pyg,

qar,

ron,

rsd,

rwf,

sar,

sbd,

scr,

sek,

sgd,

shp,

sos,

srd,

szl,

thb,

tjs,

top,

try,

ttd,

twd,

tzs,

uah,

ugx,

usd,

uyu,

uzs,

vnd,

vuv,

wst,

xaf,

xcd,

xcg,

xof,

xpf,

yer,

zar,

zmw

default_tax_behavior

enum<string>

default:location

Default Tax Behavior: Default tax behavior applied on products.

Available options:

location,

inclusive,

exclusive

Response

Response: Organization created.

created_at

string<date-time>

required

The time Ruba created this record.

modified_at

string<date-time> | null

required

The time this record last changed.

string<uuid4>

required

The stable identifier for this record.

name

string

required

Name: Organization name shown in checkout, customer portal, emails etc.

slug

string

required

Slug: Unique organization slug in checkout, customer portal and credit card statements.

avatar_url

string | null

required

Avatar Url: Avatar URL shown in checkout, customer portal, emails etc.

proration_behavior

enum<string>

required

Proration Behavior: Proration behavior applied when customer updates their subscription from the portal.

Available options:

invoice,

prorate,

next_period,

reset

allow_customer_updates

boolean

required

Indicates whether customers can update their subscriptions from the customer portal.

string | null

required

Email: Public support email.

website

string | null

required

Website: Official website of the organization.

socials

OrganizationSocialLink · object[]

required

Socials: Links to social profiles.

Show child attributes

status

enum<string>

required

Status: Current organization status.

Available options:

created,

review,

snoozed,

denied,

active,

blocked,

offboarding,

offboarded

details_submitted_at

string<date-time> | null

required

Details Submitted At: When the business details were submitted for review.

default_presentment_currency

string

required

Default Presentment Currency: Default presentment currency. Used as fallback in checkout and customer portal, if the customer's local currency is not available.

default_tax_behavior

enum<string>

required

Default Tax Behavior: Default tax behavior applied on products.

Available options:

location,

inclusive,

exclusive

feature_settings

OrganizationFeatureSettings · object | null

required

Feature Settings: Organization feature settings.

Show child attributes

subscription_settings

OrganizationSubscriptionSettings · object

required

Subscription Settings: Settings related to subscriptions management.

Show child attributes

customer_email_settings

OrganizationCustomerEmailSettings · object

required

Customer Email Settings: Settings related to customer emails.

Show child attributes

customer_portal_settings

OrganizationCustomerPortalSettings · object

required

Customer Portal Settings: Settings related to the customer portal.

Show child attributes

account_id

string<uuid4> | null

required

Identifier of the transactions account.

payout_account_id

string<uuid4> | null

required

Identifier of the payout account.

capabilities

OrganizationCapabilities · object

required

Capabilities: Capabilities currently granted to the organization.

Show child attributes

country

enum<string> | null

Country: Two-letter country code (ISO 3166-1 alpha-2).

Available options:

AD,

AE,

AF,

AG,

AI,

AL,

AM,

AO,

AQ,

AR,

AS,

AT,

AU,

AW,

AX,

AZ,

BA,

BB,

BD,

BE,

BF,

BG,

BH,

BI,

BJ,

BL,

BM,

BN,

BO,

BQ,

BR,

BS,

BT,

BV,

BW,

BY,

BZ,

CA,

CC,

CD,

CF,

CG,

CH,

CI,

CK,

CL,

CM,

CN,

CO,

CR,

CU,

CV,

CW,

CX,

CY,

CZ,

DE,

DJ,

DK,

DM,

DO,

DZ,

EC,

EE,

EG,

EH,

ER,

ES,

ET,

FI,

FJ,

FK,

FM,

FO,

FR,

GA,

GB,

GD,

GE,

GF,

GG,

GH,

GI,

GL,

GM,

GN,

GP,

GQ,

GR,

GS,

GT,

GU,

GW,

GY,

HK,

HM,

HN,

HR,

HT,

HU,

ID,

IE,

IL,

IM,

IN,

IO,

IQ,

IR,

IS,

IT,

JE,

JM,

JO,

JP,

KE,

KG,

KH,

KI,

KM,

KN,

KP,

KR,

KW,

KY,

KZ,

LA,

LB,

LC,

LI,

LK,

LR,

LS,

LT,

LU,

LV,

LY,

MA,

MC,

MD,

ME,

MF,

MG,

MH,

MK,

ML,

MM,

MN,

MO,

MP,

MQ,

MR,

MS,

MT,

MU,

MV,

MW,

MX,

MY,

MZ,

NA,

NC,

NE,

NF,

NG,

NI,

NL,

NO,

NP,

NR,

NU,

NZ,

OM,

PA,

PE,

PF,

PG,

PH,

PK,

PL,

PM,

PN,

PR,

PS,

PT,

PW,

PY,

QA,

RE,

RO,

RS,

RU,

RW,

SA,

SB,

SC,

SD,

SE,

SG,

SH,

SI,

SJ,

SK,

SL,

SM,

SN,

SO,

SR,

SS,

ST,

SV,

SX,

SY,

SZ,

TC,

TD,

TF,

TG,

TH,

TJ,

TK,

TL,

TM,

TN,

TO,

TR,

TT,

TV,

TW,

TZ,

UA,

UG,

UM,

US,

UY,

UZ,

VA,

VC,

VE,

VG,

VI,

VN,

VU,

WF,

WS,

YE,

YT,

ZA,

ZM,

ZW

Change Organization### Intent Applies the supplied changes to the organization. ### When to call it Call this when the organization already exists and its stored values need to change. ### Access boundary Authorize the request with a token that carries `organizations:write`. ### Successful result A successful request returns `200`. The response schema below defines the body your integration receives.

⌘I

Create Organization

curl --request POST \
  --url https://api.getruba.com/v1/organizations/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "slug": "<string>",
  "avatar_url": "<string>",
  "legal_entity": {
    "type": "<string>"
  },
  "email": "jsmith@example.com",
  "website": "<string>",
  "socials": [
    {
      "url": "<string>"
    }
  ],
  "details": {
    "about": "<string>",
    "product_description": "<string>",
    "selling_categories": [
      "<string>"
    ],
    "pricing_models": [
      "<string>"
    ],
    "intended_use": "<string>",
    "customer_acquisition": [
      "<string>"
    ],
    "future_annual_revenue": 1,
    "switching": false,
    "previous_annual_revenue": 1
  },
  "feature_settings": {
    "seat_based_pricing_enabled": false,
    "member_model_enabled": false,
    "checkout_localization_enabled": false,
    "overview_metrics": [
      "<string>"
    ]
  },
  "subscription_settings": {
    "allow_multiple_subscriptions": true,
    "benefit_revocation_grace_period": 123,
    "prevent_trial_abuse": true,
    "allow_customer_updates": true
  },
  "customer_email_settings": {
    "order_confirmation": true,
    "subscription_cancellation": true,
    "subscription_confirmation": true,
    "subscription_cycled": true,
    "subscription_cycled_after_trial": true,
    "subscription_past_due": true,
    "subscription_renewal_reminder": true,
    "subscription_revoked": true,
    "subscription_trial_conversion_reminder": true,
    "subscription_uncanceled": true,
    "subscription_updated": true
  },
  "customer_portal_settings": {
    "usage": {
      "show": true
    },
    "subscription": {
      "update_seats": true,
      "update_plan": true
    },
    "customer": {
      "allow_email_change": true
    }
  },
  "default_presentment_currency": "usd",
  "default_tax_behavior": "location"
}
'

import requests

url = "https://api.getruba.com/v1/organizations/"

payload = {
    "name": "<string>",
    "slug": "<string>",
    "avatar_url": "<string>",
    "legal_entity": { "type": "<string>" },
    "email": "jsmith@example.com",
    "website": "<string>",
    "socials": [{ "url": "<string>" }],
    "details": {
        "about": "<string>",
        "product_description": "<string>",
        "selling_categories": ["<string>"],
        "pricing_models": ["<string>"],
        "intended_use": "<string>",
        "customer_acquisition": ["<string>"],
        "future_annual_revenue": 1,
        "switching": False,
        "previous_annual_revenue": 1
    },
    "feature_settings": {
        "seat_based_pricing_enabled": False,
        "member_model_enabled": False,
        "checkout_localization_enabled": False,
        "overview_metrics": ["<string>"]
    },
    "subscription_settings": {
        "allow_multiple_subscriptions": True,
        "benefit_revocation_grace_period": 123,
        "prevent_trial_abuse": True,
        "allow_customer_updates": True
    },
    "customer_email_settings": {
        "order_confirmation": True,
        "subscription_cancellation": True,
        "subscription_confirmation": True,
        "subscription_cycled": True,
        "subscription_cycled_after_trial": True,
        "subscription_past_due": True,
        "subscription_renewal_reminder": True,
        "subscription_revoked": True,
        "subscription_trial_conversion_reminder": True,
        "subscription_uncanceled": True,
        "subscription_updated": True
    },
    "customer_portal_settings": {
        "usage": { "show": True },
        "subscription": {
            "update_seats": True,
            "update_plan": True
        },
        "customer": { "allow_email_change": True }
    },
    "default_presentment_currency": "usd",
    "default_tax_behavior": "location"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    slug: '<string>',
    avatar_url: '<string>',
    legal_entity: {type: '<string>'},
    email: 'jsmith@example.com',
    website: '<string>',
    socials: [{url: '<string>'}],
    details: {
      about: '<string>',
      product_description: '<string>',
      selling_categories: ['<string>'],
      pricing_models: ['<string>'],
      intended_use: '<string>',
      customer_acquisition: ['<string>'],
      future_annual_revenue: 1,
      switching: false,
      previous_annual_revenue: 1
    },
    feature_settings: {
      seat_based_pricing_enabled: false,
      member_model_enabled: false,
      checkout_localization_enabled: false,
      overview_metrics: ['<string>']
    },
    subscription_settings: {
      allow_multiple_subscriptions: true,
      benefit_revocation_grace_period: 123,
      prevent_trial_abuse: true,
      allow_customer_updates: true
    },
    customer_email_settings: {
      order_confirmation: true,
      subscription_cancellation: true,
      subscription_confirmation: true,
      subscription_cycled: true,
      subscription_cycled_after_trial: true,
      subscription_past_due: true,
      subscription_renewal_reminder: true,
      subscription_revoked: true,
      subscription_trial_conversion_reminder: true,
      subscription_uncanceled: true,
      subscription_updated: true
    },
    customer_portal_settings: {
      usage: {show: true},
      subscription: {update_seats: true, update_plan: true},
      customer: {allow_email_change: true}
    },
    default_presentment_currency: 'usd',
    default_tax_behavior: 'location'
  })
};

fetch('https://api.getruba.com/v1/organizations/', 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://api.getruba.com/v1/organizations/",
  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' => '<string>',
    'slug' => '<string>',
    'avatar_url' => '<string>',
    'legal_entity' => [
        'type' => '<string>'
    ],
    'email' => 'jsmith@example.com',
    'website' => '<string>',
    'socials' => [
        [
                'url' => '<string>'
        ]
    ],
    'details' => [
        'about' => '<string>',
        'product_description' => '<string>',
        'selling_categories' => [
                '<string>'
        ],
        'pricing_models' => [
                '<string>'
        ],
        'intended_use' => '<string>',
        'customer_acquisition' => [
                '<string>'
        ],
        'future_annual_revenue' => 1,
        'switching' => false,
        'previous_annual_revenue' => 1
    ],
    'feature_settings' => [
        'seat_based_pricing_enabled' => false,
        'member_model_enabled' => false,
        'checkout_localization_enabled' => false,
        'overview_metrics' => [
                '<string>'
        ]
    ],
    'subscription_settings' => [
        'allow_multiple_subscriptions' => true,
        'benefit_revocation_grace_period' => 123,
        'prevent_trial_abuse' => true,
        'allow_customer_updates' => true
    ],
    'customer_email_settings' => [
        'order_confirmation' => true,
        'subscription_cancellation' => true,
        'subscription_confirmation' => true,
        'subscription_cycled' => true,
        'subscription_cycled_after_trial' => true,
        'subscription_past_due' => true,
        'subscription_renewal_reminder' => true,
        'subscription_revoked' => true,
        'subscription_trial_conversion_reminder' => true,
        'subscription_uncanceled' => true,
        'subscription_updated' => true
    ],
    'customer_portal_settings' => [
        'usage' => [
                'show' => true
        ],
        'subscription' => [
                'update_seats' => true,
                'update_plan' => true
        ],
        'customer' => [
                'allow_email_change' => true
        ]
    ],
    'default_presentment_currency' => 'usd',
    'default_tax_behavior' => 'location'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "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://api.getruba.com/v1/organizations/"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"slug\": \"<string>\",\n  \"avatar_url\": \"<string>\",\n  \"legal_entity\": {\n    \"type\": \"<string>\"\n  },\n  \"email\": \"jsmith@example.com\",\n  \"website\": \"<string>\",\n  \"socials\": [\n    {\n      \"url\": \"<string>\"\n    }\n  ],\n  \"details\": {\n    \"about\": \"<string>\",\n    \"product_description\": \"<string>\",\n    \"selling_categories\": [\n      \"<string>\"\n    ],\n    \"pricing_models\": [\n      \"<string>\"\n    ],\n    \"intended_use\": \"<string>\",\n    \"customer_acquisition\": [\n      \"<string>\"\n    ],\n    \"future_annual_revenue\": 1,\n    \"switching\": false,\n    \"previous_annual_revenue\": 1\n  },\n  \"feature_settings\": {\n    \"seat_based_pricing_enabled\": false,\n    \"member_model_enabled\": false,\n    \"checkout_localization_enabled\": false,\n    \"overview_metrics\": [\n      \"<string>\"\n    ]\n  },\n  \"subscription_settings\": {\n    \"allow_multiple_subscriptions\": true,\n    \"benefit_revocation_grace_period\": 123,\n    \"prevent_trial_abuse\": true,\n    \"allow_customer_updates\": true\n  },\n  \"customer_email_settings\": {\n    \"order_confirmation\": true,\n    \"subscription_cancellation\": true,\n    \"subscription_confirmation\": true,\n    \"subscription_cycled\": true,\n    \"subscription_cycled_after_trial\": true,\n    \"subscription_past_due\": true,\n    \"subscription_renewal_reminder\": true,\n    \"subscription_revoked\": true,\n    \"subscription_trial_conversion_reminder\": true,\n    \"subscription_uncanceled\": true,\n    \"subscription_updated\": true\n  },\n  \"customer_portal_settings\": {\n    \"usage\": {\n      \"show\": true\n    },\n    \"subscription\": {\n      \"update_seats\": true,\n      \"update_plan\": true\n    },\n    \"customer\": {\n      \"allow_email_change\": true\n    }\n  },\n  \"default_presentment_currency\": \"usd\",\n  \"default_tax_behavior\": \"location\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	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://api.getruba.com/v1/organizations/")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"slug\": \"<string>\",\n  \"avatar_url\": \"<string>\",\n  \"legal_entity\": {\n    \"type\": \"<string>\"\n  },\n  \"email\": \"jsmith@example.com\",\n  \"website\": \"<string>\",\n  \"socials\": [\n    {\n      \"url\": \"<string>\"\n    }\n  ],\n  \"details\": {\n    \"about\": \"<string>\",\n    \"product_description\": \"<string>\",\n    \"selling_categories\": [\n      \"<string>\"\n    ],\n    \"pricing_models\": [\n      \"<string>\"\n    ],\n    \"intended_use\": \"<string>\",\n    \"customer_acquisition\": [\n      \"<string>\"\n    ],\n    \"future_annual_revenue\": 1,\n    \"switching\": false,\n    \"previous_annual_revenue\": 1\n  },\n  \"feature_settings\": {\n    \"seat_based_pricing_enabled\": false,\n    \"member_model_enabled\": false,\n    \"checkout_localization_enabled\": false,\n    \"overview_metrics\": [\n      \"<string>\"\n    ]\n  },\n  \"subscription_settings\": {\n    \"allow_multiple_subscriptions\": true,\n    \"benefit_revocation_grace_period\": 123,\n    \"prevent_trial_abuse\": true,\n    \"allow_customer_updates\": true\n  },\n  \"customer_email_settings\": {\n    \"order_confirmation\": true,\n    \"subscription_cancellation\": true,\n    \"subscription_confirmation\": true,\n    \"subscription_cycled\": true,\n    \"subscription_cycled_after_trial\": true,\n    \"subscription_past_due\": true,\n    \"subscription_renewal_reminder\": true,\n    \"subscription_revoked\": true,\n    \"subscription_trial_conversion_reminder\": true,\n    \"subscription_uncanceled\": true,\n    \"subscription_updated\": true\n  },\n  \"customer_portal_settings\": {\n    \"usage\": {\n      \"show\": true\n    },\n    \"subscription\": {\n      \"update_seats\": true,\n      \"update_plan\": true\n    },\n    \"customer\": {\n      \"allow_email_change\": true\n    }\n  },\n  \"default_presentment_currency\": \"usd\",\n  \"default_tax_behavior\": \"location\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.getruba.com/v1/organizations/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"slug\": \"<string>\",\n  \"avatar_url\": \"<string>\",\n  \"legal_entity\": {\n    \"type\": \"<string>\"\n  },\n  \"email\": \"jsmith@example.com\",\n  \"website\": \"<string>\",\n  \"socials\": [\n    {\n      \"url\": \"<string>\"\n    }\n  ],\n  \"details\": {\n    \"about\": \"<string>\",\n    \"product_description\": \"<string>\",\n    \"selling_categories\": [\n      \"<string>\"\n    ],\n    \"pricing_models\": [\n      \"<string>\"\n    ],\n    \"intended_use\": \"<string>\",\n    \"customer_acquisition\": [\n      \"<string>\"\n    ],\n    \"future_annual_revenue\": 1,\n    \"switching\": false,\n    \"previous_annual_revenue\": 1\n  },\n  \"feature_settings\": {\n    \"seat_based_pricing_enabled\": false,\n    \"member_model_enabled\": false,\n    \"checkout_localization_enabled\": false,\n    \"overview_metrics\": [\n      \"<string>\"\n    ]\n  },\n  \"subscription_settings\": {\n    \"allow_multiple_subscriptions\": true,\n    \"benefit_revocation_grace_period\": 123,\n    \"prevent_trial_abuse\": true,\n    \"allow_customer_updates\": true\n  },\n  \"customer_email_settings\": {\n    \"order_confirmation\": true,\n    \"subscription_cancellation\": true,\n    \"subscription_confirmation\": true,\n    \"subscription_cycled\": true,\n    \"subscription_cycled_after_trial\": true,\n    \"subscription_past_due\": true,\n    \"subscription_renewal_reminder\": true,\n    \"subscription_revoked\": true,\n    \"subscription_trial_conversion_reminder\": true,\n    \"subscription_uncanceled\": true,\n    \"subscription_updated\": true\n  },\n  \"customer_portal_settings\": {\n    \"usage\": {\n      \"show\": true\n    },\n    \"subscription\": {\n      \"update_seats\": true,\n      \"update_plan\": true\n    },\n    \"customer\": {\n      \"allow_email_change\": true\n    }\n  },\n  \"default_presentment_currency\": \"usd\",\n  \"default_tax_behavior\": \"location\"\n}"

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

{
  "created_at": "2023-11-07T05:31:56Z",
  "modified_at": "2023-11-07T05:31:56Z",
  "id": "<string>",
  "name": "<string>",
  "slug": "<string>",
  "avatar_url": "<string>",
  "allow_customer_updates": true,
  "email": "<string>",
  "website": "<string>",
  "socials": [
    {
      "url": "<string>"
    }
  ],
  "details_submitted_at": "2023-11-07T05:31:56Z",
  "default_presentment_currency": "<string>",
  "feature_settings": {
    "issue_funding_enabled": false,
    "seat_based_pricing_enabled": false,
    "wallets_enabled": false,
    "member_model_enabled": false,
    "checkout_localization_enabled": false,
    "overview_metrics": [
      "<string>"
    ],
    "reset_proration_behavior_enabled": false,
    "off_session_charges_enabled": false,
    "slack_benefit_enabled": false,
    "preview_access_enabled": false,
    "disputes_enabled": false
  },
  "subscription_settings": {
    "allow_multiple_subscriptions": true,
    "benefit_revocation_grace_period": 123,
    "prevent_trial_abuse": true,
    "allow_customer_updates": true
  },
  "customer_email_settings": {
    "order_confirmation": true,
    "subscription_cancellation": true,
    "subscription_confirmation": true,
    "subscription_cycled": true,
    "subscription_cycled_after_trial": true,
    "subscription_past_due": true,
    "subscription_renewal_reminder": true,
    "subscription_revoked": true,
    "subscription_trial_conversion_reminder": true,
    "subscription_uncanceled": true,
    "subscription_updated": true
  },
  "customer_portal_settings": {
    "usage": {
      "show": true
    },
    "subscription": {
      "update_seats": true,
      "update_plan": true
    },
    "customer": {
      "allow_email_change": true
    }
  },
  "account_id": "<string>",
  "payout_account_id": "<string>",
  "capabilities": {
    "checkout_payments": true,
    "subscription_renewals": true,
    "payouts": true,
    "refunds": true,
    "api_access": true,
    "dashboard_access": true
  }
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Read This First

Create a Sale

Collect and Reconcile

Manage Recurring Revenue

Model Customer Access

Power the Customer Portal

Configure the Platform

React to State Changes

Create Organization

Intent

When to call it

Access boundary

Successful result

Authorizations

Body

Response