Create a new organization under the authenticated organization

POST /api/v1/organization

Creates a new organization with various details including legal information, address, bank accounts, and owners. The user must be authenticated and provide required fields such as legalName, legalType, and taxId.

application/json

Body Required

  • name string

    The name of the new organization

  • A brief description of the organization

  • type string

    Type of organization

  • Descriptor for the organization

  • Legal name of the organization

  • Legal type of the organization

  • taxId string

    Tax identification number for the organization

  • phone string

    Contact phone number for the organization

  • email string

    Contact email for the organization

  • website string

    Website URL for the organization

  • address object

    Address details for the organization

    Additional properties are allowed.

    Hide address attributes Show address attributes object
  • bankAccounts array[object]

    List of bank accounts associated with the organization

    Hide bankAccounts attributes Show bankAccounts attributes object
    • nickname string

      Nickname for the bank account

    • routing string

      Routing number for the bank account

    • account string

      Account number (will be encrypted before storage)

  • owners array[object]

    List of owners associated with the organization

    Hide owners attributes Show owners attributes object
    • First name of the owner

    • lastname string

      Last name of the owner

    • birthdate string(date)

      Birthdate of the owner

    • taxId string

      Tax identification number of the owner

    • email string

      Contact email of the owner

    • phone string

      Contact phone number of the owner

    • Ownership percentage of the owner

    • address object

      Address details for the owner

      Additional properties are allowed.

      Hide address attributes Show address attributes object

Responses

  • 200 application/json

    Organization created successfully with details including bank accounts and owners.

    Hide response attributes Show response attributes object
    • id string

      Unique identifier for the created organization

    • name string

      Name of the organization

    • Legal name of the organization

    • Legal type of the organization

    • taxId string

      Tax identification number of the organization

    • address object

      Address of the organization

      Additional properties are allowed.

    • List of bank accounts associated with the organization

    • owners array

      List of owners associated with the organization

  • Invalid request. Required fields are missing.

  • Not authenticated. The user must be logged in to access this endpoint.

POST /api/v1/organization
curl \
 --request POST https://ark.collegecanine.com/api/v1/organization \
 --header "Content-Type: application/json" \
 --data '{"name":"string","description":"string","logo":"string","type":"string","descriptor":"string","legalName":"string","legalType":"string","taxId":"string","phone":"string","email":"string","website":"string","address":{"line1":"string","line2":"string","division":"string","city":"string","postal":"string","country":"string"},"bankAccounts":[{"nickname":"string","routing":"string","account":"string"}],"owners":[{"firstname":"string","lastname":"string","birthdate":"2025-05-04","taxId":"string","email":"string","phone":"string","ownership":42.0,"address":{"line1":"string","line2":"string","division":"string","city":"string","postal":"string","country":"string"}}]}'
Request examples
{
  "name": "string",
  "description": "string",
  "logo": "string",
  "type": "string",
  "descriptor": "string",
  "legalName": "string",
  "legalType": "string",
  "taxId": "string",
  "phone": "string",
  "email": "string",
  "website": "string",
  "address": {
    "line1": "string",
    "line2": "string",
    "division": "string",
    "city": "string",
    "postal": "string",
    "country": "string"
  },
  "bankAccounts": [
    {
      "nickname": "string",
      "routing": "string",
      "account": "string"
    }
  ],
  "owners": [
    {
      "firstname": "string",
      "lastname": "string",
      "birthdate": "2025-05-04",
      "taxId": "string",
      "email": "string",
      "phone": "string",
      "ownership": 42.0,
      "address": {
        "line1": "string",
        "line2": "string",
        "division": "string",
        "city": "string",
        "postal": "string",
        "country": "string"
      }
    }
  ]
}
Response examples (200)
{
  "id": "string",
  "name": "string",
  "legalName": "string",
  "legalType": "string",
  "taxId": "string",
  "address": {},
  "bankAccounts": [],
  "owners": []
}