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