Skip to main content
POST
/
orgs
/
{org_id}
/
orgs
Create Sub-Organization
curl --request POST \
  --url https://api.useinvent.com/orgs/{org_id}/orgs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "referral_code": "<string>",
  "logo_id": "<string>",
  "features": {
    "allow_overdraft": true,
    "workflows": true,
    "broadcasts": true,
    "enable_japifon": true
  },
  "billing": {
    "use_parent_balance": true,
    "last_low_balance_notification_at": "2023-11-07T05:31:56Z",
    "last_out_of_balance_notification_at": "2023-11-07T05:31:56Z",
    "last_spending_cap_notification_at": "2023-11-07T05:31:56Z"
  }
}
'
{
  "id": "<string>",
  "name": "<string>",
  "logo_url": "<string>",
  "balance": 123,
  "promo_balance": 123,
  "billing": {
    "auto_recharge": {
      "enabled": true,
      "recharge_threshold": 252.5,
      "recharge_amount": 252.5
    },
    "use_parent_balance": true,
    "spending_cap": {
      "enabled": true,
      "amount": 50000,
      "reset_at": "2023-11-07T05:31:56Z"
    },
    "payment_method": {
      "type": "<string>",
      "payment_method_id": "<string>",
      "brand": "<string>",
      "last4": "<string>",
      "inactive": true,
      "failed_at": "2023-11-07T05:31:56Z",
      "failed_message": "<string>"
    },
    "last_low_balance_notification_at": "2023-11-07T05:31:56Z",
    "last_out_of_balance_notification_at": "2023-11-07T05:31:56Z",
    "last_spending_cap_notification_at": "2023-11-07T05:31:56Z"
  },
  "members": [
    {
      "id": "<string>",
      "name": "<string>",
      "email": "jsmith@example.com",
      "avatar": "<string>",
      "org_id": "<string>",
      "user_id": "<string>",
      "preferences": {
        "notifications": {
          "assigned_to_me": {
            "enabled": true,
            "notified_at": "2023-11-07T05:31:56Z"
          }
        }
      },
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "seen_at": "2023-11-07T05:31:56Z"
    }
  ],
  "spending_cap_used": 123,
  "created_at": "2023-11-07T05:31:56Z",
  "features": {
    "enterprise": true,
    "allow_overdraft": true,
    "workflows": true,
    "broadcasts": true,
    "enable_japifon": true,
    "slack_access": true
  },
  "config": {
    "email": "jsmith@example.com",
    "address": "<string>",
    "terms_url": "<string>",
    "privacy_url": "<string>",
    "access": {
      "allow_google": true,
      "allow_microsoft": true,
      "allow_email_code": true,
      "allow_invites": true
    },
    "modules": {
      "enable_inbox": true,
      "enable_analytics": true,
      "enable_assistants": true,
      "enable_knowledge_base": true,
      "enable_broadcasts": true,
      "enable_workflows": true,
      "enable_audience": true,
      "enable_balance_credits": true
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.useinvent.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer token authentication using your API key

Path Parameters

​
org_id
string
required

The ID of the org

Body

Schema for creating a sub-organization

​
name
string
required
Required string length: 2 - 64
​
referral_code
string
Maximum string length: 128
​
logo_id
string | null
Maximum string length: 128
​
features
object

Delegatable features configuration for sub-orgs

​
billing
object

Response

200 - application/json

Created sub-organization with its plan, balance, members, and features.

Summary information about a sub-organization

​
id
string
required

Unique identifier of the sub-organization

​
name
string
required

Name of the sub-organization

​
logo_url
string | null
required

URL of the sub-organization logo

​
plan
enum<string>
required

Type of subscription plan

Available options:
free,
business
​
balance
number
required

Current credit balance

​
promo_balance
number
required

Current promotional credit balance

​
billing
object
required

Schema for updating payment configuration

​
members
object[]
required

Members of the sub-organization

​
spending_cap_used
number
required

Amount spent in the current month

​
created_at
string<date-time> | null
required

Timestamp when the sub-organization was created

​
features
object

Org gate-keeping features configuration

​
config
object

Organization configuration settings