Skip to main content
POST
/
v1
/
companies
Create a new company
curl --request POST \
  --url https://api.wellapp.ai/v1/companies \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '{
  "type": "company",
  "attributes": {
    "description": "Enterprise open source solutions company.",
    "locale": "en",
    "domain_name_primary_link_url": "acme.com",
    "tax_id": {
      "value": "DE123456789",
      "type": "VAT"
    },
    "registration": {
      "trade_name": "TechSol",
      "registered_name": "Tech Solutions GmbH"
    },
    "registration_number": {
      "business_type": "GmbH",
      "value": "HRB 123456",
      "registry_name": "Handelsregister Berlin",
      "registry_country": "DE"
    }
  },
  "relationships": {
    "created_by": {
      "data": {
        "type": "people",
        "id": "people1"
      }
    },
    "media": {
      "data": [
        {
          "type": "media",
          "id": "media1"
        }
      ]
    },
    "web_links": {
      "data": [
        {
          "type": "web_link",
          "id": "sl1"
        }
      ]
    },
    "emails": {
      "data": [
        {
          "type": "email",
          "id": "email1"
        }
      ]
    },
    "phones": {
      "data": [
        {
          "type": "phone",
          "id": "phone1"
        }
      ]
    },
    "locations": {
      "data": [
        {
          "type": "location",
          "id": "loc1"
        }
      ]
    },
    "people": {
      "data": [
        {
          "type": "people",
          "id": "people1",
          "meta": {
            "relationship_type": "owner"
          }
        }
      ]
    },
    "parents": {
      "data": {
        "type": "company",
        "id": "parent_company1"
      }
    },
    "subsidiaries": {
      "data": [
        {
          "type": "company",
          "id": "subsidiary1"
        }
      ]
    },
    "workspaces": {
      "data": [
        {
          "type": "workspace",
          "id": "workspace_tenant"
        }
      ]
    }
  },
  "included": [
    {
      "type": "people",
      "id": "people1",
      "attributes": {
        "first_name": "John",
        "last_name": "Doe",
        "full_name": "John Doe"
      }
    },
    {
      "type": "media",
      "id": "media1",
      "attributes": {
        "file_name": "company_logo.png",
        "media_type": "logo",
        "is_primary": true
      }
    },
    {
      "type": "web_link",
      "id": "sl1",
      "attributes": {
        "url": "https://www.linkedin.com/company/acme",
        "platform": "linkedin"
      }
    },
    {
      "type": "email",
      "id": "email1",
      "attributes": {
        "value": "contact@acme.com",
        "label": "work",
        "is_primary": true
      }
    },
    {
      "type": "phone",
      "id": "phone1",
      "attributes": {
        "e164_number": "+33123456789",
        "label": "work",
        "is_primary": true
      }
    },
    {
      "type": "location",
      "id": "loc1",
      "attributes": {
        "street": "123 Tech Street",
        "city": "Berlin",
        "postal_code": "10115",
        "country": "DE",
        "is_primary": true
      }
    },
    {
      "type": "workspace",
      "id": "workspace_tenant",
      "attributes": {
        "name": "Main Workspace",
        "description": "Primary workspace for ACME operations"
      }
    },
    {
      "type": "company",
      "id": "parent_company1",
      "attributes": {
        "name": "ACME Global Holdings",
        "description": "Parent company of ACME",
        "registration": {
          "registered_name": "ACME Global Holdings GmbH"
        }
      }
    },
    {
      "type": "company",
      "id": "subsidiary1",
      "attributes": {
        "name": "ACME France",
        "description": "French subsidiary of ACME",
        "registration": {
          "registered_name": "ACME France SAS"
        }
      }
    },
    {
      "type": "document",
      "id": "550e8400-e29b-41d4-a716-446655440016",
      "attributes": {
        "name": "company_registration.pdf",
        "file_size": 245678,
        "content_type": "application/pdf",
        "created_at": "2025-09-25T10:00:00.000Z"
      }
    }
  ]
}'
{
  "data": {
    "type": "company",
    "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "attributes": {
      "description": "Enterprise open source solutions company.",
      "locale": "en",
      "domain_name_primary_link_url": "acme.com",
      "tax_id": {
        "value": "DE123456789",
        "type": "VAT"
      },
      "registration": {
        "trade_name": "TechSol",
        "registered_name": "Tech Solutions GmbH"
      },
      "registration_number": {
        "business_type": "GmbH",
        "value": "HRB 123456",
        "registry_name": "Handelsregister Berlin",
        "registry_country": "DE"
      },
      "created_at": "2025-09-30T14:30:00.000Z",
      "updated_at": "2025-09-30T14:30:00.000Z"
    },
    "relationships": {
      "created_by": {
        "data": {
          "type": "people",
          "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8"
        }
      },
      "media": {
        "data": [
          {
            "type": "media",
            "id": "550e8400-e29b-41d4-a716-446655440010"
          }
        ]
      },
      "web_links": {
        "data": [
          {
            "type": "web_link",
            "id": "550e8400-e29b-41d4-a716-446655440011"
          }
        ]
      },
      "emails": {
        "data": [
          {
            "type": "email",
            "id": "550e8400-e29b-41d4-a716-446655440012"
          }
        ]
      },
      "phones": {
        "data": [
          {
            "type": "phone",
            "id": "550e8400-e29b-41d4-a716-446655440013"
          }
        ]
      },
      "locations": {
        "data": [
          {
            "type": "location",
            "id": "550e8400-e29b-41d4-a716-446655440015"
          }
        ]
      },
      "people": {
        "data": [
          {
            "type": "people",
            "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8"
          }
        ]
      },
      "documents": {
        "data": [
          {
            "type": "document",
            "id": "550e8400-e29b-41d4-a716-446655440016"
          }
        ]
      },
      "parents": {
        "data": {
          "type": "company",
          "id": "550e8400-e29b-41d4-a716-446655440019"
        }
      },
      "subsidiaries": {
        "data": [
          {
            "type": "company",
            "id": "550e8400-e29b-41d4-a716-446655440020"
          }
        ]
      },
      "workspaces": {
        "data": [
          {
            "type": "workspace",
            "id": "550e8400-e29b-41d4-a716-446655440001"
          }
        ]
      }
    }
  },
  "included": [
    {
      "type": "people",
      "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
      "attributes": {
        "first_name": "Alexandre",
        "last_name": "Dubois",
        "full_name": "Alexandre Dubois",
        "relationship_type": "owner"
      }
    },
    {
      "type": "workspace",
      "id": "550e8400-e29b-41d4-a716-446655440001",
      "attributes": {
        "name": "Development Team",
        "description": "Main development workspace for software engineering projects and client solutions",
        "created_at": "2025-09-10T08:00:00.000Z",
        "updated_at": "2025-09-15T16:45:00.000Z"
      }
    },
    {
      "type": "media",
      "id": "550e8400-e29b-41d4-a716-446655440010",
      "attributes": {
        "file_name": "company_logo.png",
        "content_type": "image/png",
        "file_size": 15678
      }
    },
    {
      "type": "web_link",
      "id": "550e8400-e29b-41d4-a716-446655440011",
      "attributes": {
        "url": "https://www.linkedin.com/company/acme",
        "platform": "linkedin"
      }
    },
    {
      "type": "email",
      "id": "550e8400-e29b-41d4-a716-446655440012",
      "attributes": {
        "value": "contact@acme.com",
        "label": "work",
        "is_primary": true
      }
    },
    {
      "type": "phone",
      "id": "550e8400-e29b-41d4-a716-446655440013",
      "attributes": {
        "e164_number": "+4930123456789",
        "label": "work",
        "is_primary": true
      }
    },
    {
      "type": "location",
      "id": "550e8400-e29b-41d4-a716-446655440015",
      "attributes": {
        "street": "Unter den Linden 1",
        "city": "Berlin",
        "postal_code": "10117",
        "country": "DE",
        "is_primary": true
      }
    },
    {
      "type": "document",
      "id": "550e8400-e29b-41d4-a716-446655440016",
      "attributes": {
        "name": "company_registration.pdf",
        "file_size": 245678,
        "content_type": "application/pdf",
        "created_at": "2025-09-25T10:00:00.000Z"
      }
    },
    {
      "type": "company",
      "id": "550e8400-e29b-41d4-a716-446655440019",
      "attributes": {
        "name": "ACME Global Holdings",
        "description": "Parent company of ACME",
        "registration": {
          "registered_name": "ACME Global Holdings GmbH"
        }
      }
    },
    {
      "type": "company",
      "id": "550e8400-e29b-41d4-a716-446655440020",
      "attributes": {
        "name": "ACME France",
        "description": "French subsidiary of ACME",
        "registration": {
          "registered_name": "ACME France SAS"
        }
      }
    }
  ]
}

Headers

​
Authorization
string
required

Bearer token for authentication

Body

application/json
​
data
object
required

Response

Company created successfully

​
data
object
⌘I