---
title: "Create a company"
method: POST
path: "/companies/v1/company"
tags: ["Companies"]
---

# Create a company

`POST /companies/v1/company`

Creates a new contractor company in your SafetyCulture organization. Requires the 'Companies: Manage' permission.

## Request body

- S12ContractorsV1CreateContractorCompanyRequest
  - `company_type_id` string, required — Required. The ID of the contractor company type.
  - `company_id` string — Optional. The ID of the new contractor company. This field must be provided if creating a company with an image. This is required to link the media to the company entity.
  - `contractor_company_attributes` S12ContractorsV1ContractorCompanyAttributes, required — Intrinsic attributes associated with a contractor company.
    - `name` string — The name of the company.
    - `contact_details` S12ContractorsV1CompanyContactDetails — Contact details associated with a contractor company.
      - `email` string — The email address of the company.
      - `phone_number` string — The phone number of the company.
      - `address` S12ContractorsV1Address
        - `sub_premise` string — A first-order entity below a named location eg. Building, floor level, or suite
        - `street_number` string — Street number
        - `street` string — Street name
        - `city` string — City or locality
        - `administrative_area_level_2` string — deprecated. For output, this will return the value of administrative_area_level for backward compatibility.
        - `administrative_area_level_1` string — A first-order civil entity below the country level. These do not exist in all countries. eg. within the United States: state or province, within the UK: county, within Australia: state
        - `postal_code` string — Postal code
        - `country_code` string — Country code (ISO 3166-1 alpha-2)
    - `image` S12CommonMedia
      - `id` string
      - `token` string
      - `filename` string — full file name, including file extension
      - `media_type` 'MEDIA_TYPE_IMAGE' | 'MEDIA_TYPE_VIDEO' | 'MEDIA_TYPE_PDF' | 'MEDIA_TYPE_DOCX' | 'MEDIA_TYPE_XLSX' | 'MEDIA_TYPE_PPTX' | 'MEDIA_TYPE_CSV' — - MEDIA_TYPE_IMAGE: An image file (GIF, JPG, PNG, WEBP). - MEDIA_TYPE_VIDEO: A video file (MP4, MOV). - MEDIA_TYPE_PDF: A PDF document. - MEDIA_TYPE_DOCX: A Microsoft Word document (DOCX, DOC). - MEDIA_TYPE_XLSX: A Microsoft Excel spreadsheet (XLSX, XLS). - MEDIA_TYPE_PPTX: A Microsoft PowerPoint presentation (PPTX, PPT). - MEDIA_TYPE_CSV: A CSV file.
    - `external_reference_id` string — An optional external reference ID for the company that is used in external systems. Enforces uniqueness.
    - `status` 'CONTRACTOR_COMPANY_STATUS_ACTIVE' | 'CONTRACTOR_COMPANY_STATUS_PENDING' | 'CONTRACTOR_COMPANY_STATUS_DEACTIVATED' — The status of a contractor company. - CONTRACTOR_COMPANY_STATUS_ACTIVE: The company is active. - CONTRACTOR_COMPANY_STATUS_PENDING: The company is pending approval. - CONTRACTOR_COMPANY_STATUS_DEACTIVATED: The company is deactivated.
    - `compliance_statistics` S12ContractorsV1CompanyComplianceStatistics — CompanyComplianceStatistics is a message that contains statistics about a contractor company's compliance.
      - `expired_document_count` integer — The number of company documents that have expired.
      - `expiring_soon_document_count` integer — The number of company documents that are expiring soon. The service hard-codes "expiring soon" as documents that are expiring within the next 30 days.
      - `pending_approval_document_count` integer — The number of company documents that are pending approval.
    - `user_credential_compliance_statistics` S12ContractorsV1CompanyUserCredentialComplianceStatistics — CompanyUserCredentialComplianceStatistics is a message that contains statistics about a contractor company's users' credential compliance.
      - `expired_user_credential_count` integer — The number of user credentials that have expired.
      - `expiring_soon_user_credential_count` integer — The number of user credentials that are expiring soon.
      - `pending_approval_user_credential_count` integer — The number of user credentials that are pending approval.
      - `total_user_credential_count` integer — The total number of user credentials.
    - `notes` string — An internal note about the company, visible only to users with admin:companies permission.
    - `site_ids` string[] — The IDs of the sites to associate with this company. On create: links all provided sites to the new company. On update: replaces the full set of site associations (include in update_mask to apply).
    - `linked_sites` S12ContractorsV1ContractorCompanyLinkedSite[] — The sites currently linked to this company, including resolved site names. Populated on read responses only; to modify the site associations use site_ids.
      - `site_id` string — The ID of the linked site.
      - `site_name` string — The display name of the linked site.

## Response `200`

A successful response.

- S12ContractorsV1CreateContractorCompanyResponse

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/safetyculture/apis/safetyculture-api.md) · [All operations](https://skmtc.net/safetyculture/apis/safetyculture-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/safetyculture/safetyculture-api/revisions/5be91df61ded/schema)