Create Organization

Create a new organization. The creator is automatically added as a member of the organization.

Endpoint

POST https://api.recoupable.com/api/organizations

Request Body

Name	Type	Required	Description
name	string	Yes	The name of the organization to create
accountId	string	Yes	The account ID of the creator

Request Examples

cURL

curl -X POST "https://api.recoupable.com/api/organizations" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My New Label",
    "accountId": "123e4567-e89b-12d3-a456-426614174000"
  }'

Response Format

{
  "status": "success",
  "organization": {
    "id": "new-org-uuid",
    "name": "My New Label"
  }
}

{
  "status": "error",
  "message": "name and accountId are required"
}

Response Properties

Property	Type	Description
status	string	Status of the request ("success" or "error")
organization	object	The created organization
organization.id	string	UUID of the new organization account
organization.name	string	Name of the organization
message	string	Error message (only present if status is "error")

What Happens

When you create an organization:

A new account is created for the organization
An account_info record is created for org settings
The creator is added as a member via account_organization_ids

Next Steps

After creating an organization, you can:

Add artists to the organization using Add Artist to Organization
List organization members
Configure organization settings