> ## Documentation Index > Fetch the complete documentation index at: https://docs.floral.so/llms.txt > Use this file to discover all available pages before exploring further. # Create or resolve a company > Create a company or resolve the canonical workspace company for a supplied CVR. ## OpenAPI ````yaml /openapi/public-v1.json post /api/v1/workspaces/{workspaceSlug}/companies openapi: 3.1.0 info: description: Stable external API for relationship lookup and meeting intelligence. title: Floral Public API version: 1.0.0 servers: - description: Production url: https://app.floral.so security: [] tags: - description: Search across active companies and people. name: Search - description: Create, list, inspect, update, archive, and restore companies. name: Companies - description: Create, list, inspect, update, archive, and restore people. name: People - description: Read active public custom-field definitions. name: Custom fields - description: Search normalized Danish company-register facts. name: Company registry - description: Generate, list, and inspect meeting briefings. name: Briefings - description: List, inspect, annotate, and approve meeting summaries. name: Summaries paths: /api/v1/workspaces/{workspaceSlug}/companies: post: tags: - Companies summary: Create or resolve a company description: >- Create a company or resolve the canonical workspace company for a supplied CVR. operationId: createCompanyV1 parameters: - description: Slug of the workspace pinned to the credential. example: acme-nordic in: path name: workspaceSlug required: true schema: maxLength: 100 minLength: 1 pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$ type: string - description: >- Optional caller-generated correlation ID. Floral returns the effective value in X-Request-ID. example: 550e8400-e29b-41d4-a716-446655440000 in: header name: X-Request-ID required: false schema: maxLength: 128 minLength: 1 type: string - description: >- Required idempotency key. Exact retries of the same canonical request replay the original status, body, ETag, Location, and request ID for 24 hours. example: createCompanyV1-20260816-001 in: header name: Idempotency-Key required: true schema: type: string minLength: 1 maxLength: 255 requestBody: content: application/json: example: customFields: account_tier: growth email: hello@acme-nordic.example lifecycleStage: PROSPECT metadata: source: partner-directory name: Acme Nordic organizationNumber: '12345678' website: https://acme-nordic.example schema: $ref: '#/components/schemas/CompanyCreate' description: >- Company profile. Metadata and custom fields require Work access. Maximum 65536 bytes. required: true responses: '201': content: application/json: example: company: annualRevenueOere: 12500000 archivedAt: null customFields: account_tier: growth description: Nordic workplace design and furniture supplier. email: hello@acme-nordic.example employeeCount: 48 id: 42 industry: Design lastActivityAt: '2026-08-15T09:30:00.000Z' lifecycleStage: PROSPECT linkedinUrl: https://www.linkedin.com/company/acme-nordic metadata: source: partner-directory name: Acme Nordic organizationNumber: '12345678' ownerUserIds: - user_01J5N9CF9QY8T4M2A7W3R6K1P0 people: - email: ada@acme-nordic.example id: 84 name: Ada Jensen title: Operations director phone: +45 33 12 34 56 updatedAt: '2026-08-15T09:30:00.000Z' version: >- v1.eyJpZCI6NDIsInJlc291cmNlIjoiY29tcGFueSIsInZlcnNpb24iOiIyMDI2LTA4LTE1VDA5OjMwOjAwLjAwMFoifQ website: https://acme-nordic.example schema: $ref: '#/components/schemas/CompanyDetailResponse' description: Company created or resolved headers: X-Content-Type-Options: description: Always nosniff for JSON API responses. schema: const: nosniff type: string X-RateLimit-Limit: description: Maximum requests in the current rate-limit window. schema: minimum: 1 type: integer X-RateLimit-Remaining: description: Requests remaining in the current rate-limit window. schema: minimum: 0 type: integer X-Request-ID: description: Stable request or idempotent replay correlation ID. schema: minLength: 1 type: string ETag: description: Opaque version for a subsequent If-Match. example: >- "v1.eyJpZCI6NDIsInJlc291cmNlIjoiY29tcGFueSIsInZlcnNpb24iOiIyMDI2LTA4LTE1VDA5OjMwOjAwLjAwMFoifQ" schema: pattern: ^"(?:[^"\\]|\\.)*"$ type: string Location: description: Canonical path of the created resource. example: /api/v1/workspaces/acme-nordic/companies/42 schema: format: uri-reference type: string '400': content: application/json: example: error: code: INVALID_INPUT message: The request contains invalid values. requestId: 550e8400-e29b-41d4-a716-446655440000 schema: allOf: - $ref: '#/components/schemas/ApiErrorResponse' properties: error: properties: code: enum: - INVALID_INPUT type: string required: - code type: object type: object description: 'Stable errors: INVALID_INPUT' headers: X-Content-Type-Options: description: Always nosniff for JSON API responses. schema: const: nosniff type: string X-RateLimit-Limit: description: Maximum requests in the current rate-limit window. schema: minimum: 1 type: integer X-RateLimit-Remaining: description: Requests remaining in the current rate-limit window. schema: minimum: 0 type: integer X-Request-ID: description: Stable request or idempotent replay correlation ID. schema: minLength: 1 type: string '401': content: application/json: example: error: code: UNAUTHENTICATED message: A valid bearer credential is required. requestId: 550e8400-e29b-41d4-a716-446655440000 schema: allOf: - $ref: '#/components/schemas/ApiErrorResponse' properties: error: properties: code: enum: - UNAUTHENTICATED type: string required: - code type: object type: object description: 'Stable errors: UNAUTHENTICATED' headers: X-Content-Type-Options: description: Always nosniff for JSON API responses. schema: const: nosniff type: string X-RateLimit-Limit: description: Maximum requests in the current rate-limit window. schema: minimum: 1 type: integer X-RateLimit-Remaining: description: Requests remaining in the current rate-limit window. schema: minimum: 0 type: integer X-Request-ID: description: Stable request or idempotent replay correlation ID. schema: minLength: 1 type: string WWW-Authenticate: description: Bearer authentication challenge. example: Bearer realm="floral-api" schema: type: string '403': content: application/json: example: error: code: FORBIDDEN message: The credential does not grant this operation. requestId: 550e8400-e29b-41d4-a716-446655440000 schema: allOf: - $ref: '#/components/schemas/ApiErrorResponse' properties: error: properties: code: enum: - FORBIDDEN type: string required: - code type: object type: object description: 'Stable errors: FORBIDDEN' headers: X-Content-Type-Options: description: Always nosniff for JSON API responses. schema: const: nosniff type: string X-RateLimit-Limit: description: Maximum requests in the current rate-limit window. schema: minimum: 1 type: integer X-RateLimit-Remaining: description: Requests remaining in the current rate-limit window. schema: minimum: 0 type: integer X-Request-ID: description: Stable request or idempotent replay correlation ID. schema: minLength: 1 type: string '404': content: application/json: example: error: code: NOT_FOUND message: The resource was not found. requestId: 550e8400-e29b-41d4-a716-446655440000 schema: allOf: - $ref: '#/components/schemas/ApiErrorResponse' properties: error: properties: code: enum: - NOT_FOUND - FEATURE_DISABLED type: string required: - code type: object type: object description: 'Stable errors: NOT_FOUND, FEATURE_DISABLED' headers: X-Content-Type-Options: description: Always nosniff for JSON API responses. schema: const: nosniff type: string X-RateLimit-Limit: description: Maximum requests in the current rate-limit window. schema: minimum: 1 type: integer X-RateLimit-Remaining: description: Requests remaining in the current rate-limit window. schema: minimum: 0 type: integer X-Request-ID: description: Stable request or idempotent replay correlation ID. schema: minLength: 1 type: string '409': content: application/json: example: error: code: CONFLICT message: >- The requested change conflicts with the current resource state. requestId: 550e8400-e29b-41d4-a716-446655440000 schema: allOf: - $ref: '#/components/schemas/ApiErrorResponse' properties: error: properties: code: enum: - CONFLICT - IDEMPOTENCY_CONFLICT type: string required: - code type: object type: object description: 'Stable errors: CONFLICT, IDEMPOTENCY_CONFLICT' headers: X-Content-Type-Options: description: Always nosniff for JSON API responses. schema: const: nosniff type: string X-RateLimit-Limit: description: Maximum requests in the current rate-limit window. schema: minimum: 1 type: integer X-RateLimit-Remaining: description: Requests remaining in the current rate-limit window. schema: minimum: 0 type: integer X-Request-ID: description: Stable request or idempotent replay correlation ID. schema: minLength: 1 type: string '429': content: application/json: example: error: code: RATE_LIMITED message: Too many requests. Retry shortly. requestId: 550e8400-e29b-41d4-a716-446655440000 schema: allOf: - $ref: '#/components/schemas/ApiErrorResponse' properties: error: properties: code: enum: - RATE_LIMITED type: string required: - code type: object type: object description: 'Stable errors: RATE_LIMITED' headers: X-Content-Type-Options: description: Always nosniff for JSON API responses. schema: const: nosniff type: string X-RateLimit-Limit: description: Maximum requests in the current rate-limit window. schema: minimum: 1 type: integer X-RateLimit-Remaining: description: Requests remaining in the current rate-limit window. schema: minimum: 0 type: integer X-Request-ID: description: Stable request or idempotent replay correlation ID. schema: minLength: 1 type: string Retry-After: description: Seconds until the current limit resets. schema: minimum: 1 type: integer '500': content: application/json: example: error: code: INTERNAL_ERROR message: An unexpected error occurred. requestId: 550e8400-e29b-41d4-a716-446655440000 schema: allOf: - $ref: '#/components/schemas/ApiErrorResponse' properties: error: properties: code: enum: - INTERNAL_ERROR type: string required: - code type: object type: object description: 'Stable errors: INTERNAL_ERROR' headers: X-Content-Type-Options: description: Always nosniff for JSON API responses. schema: const: nosniff type: string X-RateLimit-Limit: description: Maximum requests in the current rate-limit window. schema: minimum: 1 type: integer X-RateLimit-Remaining: description: Requests remaining in the current rate-limit window. schema: minimum: 0 type: integer X-Request-ID: description: Stable request or idempotent replay correlation ID. schema: minLength: 1 type: string security: - bearerAuth: [] x-codeSamples: - label: cURL lang: Shell source: |- curl --request POST \ --url 'https://app.floral.so/api/v1/workspaces/acme-nordic/companies' \ --header 'Authorization: Bearer $FLORAL_TOKEN' \ --header 'Idempotency-Key: createCompanyV1-20260816-001' \ --header 'Content-Type: application/json' \ --data '{ "customFields": { "account_tier": "growth" }, "email": "hello@acme-nordic.example", "lifecycleStage": "PROSPECT", "metadata": { "source": "partner-directory" }, "name": "Acme Nordic", "organizationNumber": "12345678", "website": "https://acme-nordic.example" }' components: schemas: CompanyCreate: $schema: https://json-schema.org/draft/2020-12/schema type: object properties: annualRevenueOere: anyOf: - type: integer minimum: 0 maximum: 9007199254740991 - type: 'null' customFields: maxProperties: 50 type: object propertyNames: type: string pattern: ^[a-z][a-z0-9_]{0,62}$ additionalProperties: anyOf: - type: string maxLength: 5000 - type: number - type: boolean - maxItems: 50 type: array items: type: string maxLength: 1000 description: anyOf: - type: string maxLength: 5000 - type: 'null' email: anyOf: - type: string maxLength: 320 format: email pattern: >- ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ - type: 'null' employeeCount: anyOf: - type: integer minimum: 0 maximum: 10000000 - type: 'null' industry: anyOf: - type: string maxLength: 128 - type: 'null' lifecycleStage: anyOf: - type: string enum: - LEAD - PROSPECT - CUSTOMER - CHURNED - type: 'null' linkedinUrl: anyOf: - type: string maxLength: 255 pattern: ^https?:\/\/ - type: 'null' metadata: maxProperties: 50 type: object propertyNames: type: string minLength: 1 maxLength: 40 additionalProperties: type: string maxLength: 500 name: type: string minLength: 1 maxLength: 255 phone: anyOf: - type: string maxLength: 32 - type: 'null' website: anyOf: - type: string maxLength: 255 pattern: ^https?:\/\/ - type: 'null' organizationNumber: type: string pattern: ^\d{8}$ required: - name additionalProperties: false CompanyDetailResponse: $schema: https://json-schema.org/draft/2020-12/schema type: object properties: company: type: object properties: id: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 version: type: string minLength: 1 maxLength: 512 pattern: ^v1\.[A-Za-z0-9_-]+$ name: type: string minLength: 1 maxLength: 255 organizationNumber: type: string pattern: ^(?:|\d{8})$ email: anyOf: - type: string maxLength: 320 format: email pattern: >- ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ - type: 'null' phone: anyOf: - type: string maxLength: 32 - type: 'null' website: anyOf: - type: string maxLength: 255 pattern: ^https?:\/\/ - type: 'null' industry: anyOf: - type: string maxLength: 128 - type: 'null' employeeCount: anyOf: - type: integer minimum: 0 maximum: 10000000 - type: 'null' annualRevenueOere: anyOf: - type: integer minimum: 0 maximum: 9007199254740991 - type: 'null' description: anyOf: - type: string maxLength: 5000 - type: 'null' linkedinUrl: anyOf: - type: string maxLength: 255 pattern: ^https?:\/\/ - type: 'null' lifecycleStage: anyOf: - type: string enum: - LEAD - PROSPECT - CUSTOMER - CHURNED - type: 'null' lastActivityAt: anyOf: - type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ - type: 'null' archivedAt: anyOf: - type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ - type: 'null' updatedAt: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ metadata: maxProperties: 50 type: object propertyNames: type: string minLength: 1 maxLength: 40 additionalProperties: type: string maxLength: 500 customFields: maxProperties: 50 type: object propertyNames: type: string pattern: ^[a-z][a-z0-9_]{0,62}$ additionalProperties: anyOf: - type: string maxLength: 5000 - type: number - type: boolean - maxItems: 50 type: array items: type: string maxLength: 1000 ownerUserIds: maxItems: 50 type: array items: type: string minLength: 1 maxLength: 255 people: maxItems: 50 type: array items: type: object properties: id: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 name: type: string email: type: string title: anyOf: - type: string - type: 'null' required: - id - name - email - title additionalProperties: false required: - id - version - name - organizationNumber - email - phone - website - industry - employeeCount - annualRevenueOere - description - linkedinUrl - lifecycleStage - lastActivityAt - archivedAt - updatedAt - metadata - customFields - ownerUserIds - people additionalProperties: false required: - company additionalProperties: false ApiErrorResponse: additionalProperties: false properties: error: additionalProperties: false properties: code: enum: - CONFLICT - FEATURE_DISABLED - FORBIDDEN - IDEMPOTENCY_CONFLICT - INTERNAL_ERROR - INVALID_INPUT - INVALID_STATE - NOT_FOUND - PRECONDITION_REQUIRED - RATE_LIMITED - UNAUTHENTICATED - VERSION_CONFLICT type: string message: minLength: 1 type: string requestId: maxLength: 128 minLength: 1 type: string required: - code - message - requestId type: object required: - error type: object securitySchemes: bearerAuth: bearerFormat: Floral PAT description: Authenticate with a workspace-pinned Floral personal access token. scheme: bearer type: http ````