--- search: tags: - organizations - POST seo: description: >- Creates a new organization (external business partner) in your workspace. Reference for the POST /organizations endpoint in the Leadtime Public API API. sidebar: badge: POST label: Create organization title: Create organization type: openapi-operation --- Creates a new organization (external business partner) in your workspace. **What are Organizations?** Organizations represent external business partners like customers, suppliers, partners, or competitors. They serve as the foundation for managing external projects, contacts, invoices, and business relationships. **Required fields:** - name: Full company name (e.g., "Acme Corporation") - type: Organization type (Customer, Prospect, Supplier, Partner, etc.) - color: Hex color code for visual identification (e.g., "#FF5733") **Optional fields:** - shortName: 3-5 character abbreviation (auto-generated if not provided) - icon: Icon identifier for visual representation - legalForm: Legal company form (e.g., "GmbH", "AG", "LLC") - startOfCollaboration: Date when business relationship started (ISO date format: YYYY-MM-DD) - Contact information: Address fields, phone, fax, email, website - Legal information: Tax number, registration number, registration court - Invoice settings: Hourly rate, payment terms, reminder fees, interest rates - Document settings: Table of contents, title page, heading style - customFields: Values keyed by configured organization custom-field IDs. Values must match their definition types. Custom fields store typed data; they do not create native relationships or behavior. **Uploading a logo:** 1. First, call POST /api/public/workspace/upload to upload the logo file 2. The upload endpoint returns a file ID (UUID) 3. Use that file ID in the logoId field when creating the organization **Auto-generated fields:** - If shortName is not provided, it will be automatically generated from the organization name - The organization will be created with isActive: true by default **What is returned:** The complete organization object with all fields, including computed values like logoUrl and timestamps. **Note:** This endpoint requires the Organizations.create permission. All validation errors will be returned with detailed field-level messages.