---
title: "Add a new integration to a company"
method: POST
path: "/company/integrations"
tags: ["Integrations"]
---

# Add a new integration to a company

`POST /company/integrations`

Add a new integration to a company

## Headers

- `X-Company-ID` string, required

## Request body

- CompanyIntegration — A serializer mixin that allows dynamic inclusion or exclusion of serializer fields by passing `fields=[...]` or `exclude_fields=[...]` when initializing.
  - `id` string, uuid, required
  - `integration` Integration, required
    - `id` integer, required
    - `source` 'METABASE' | 'QUICKBOOKS' | 'XERO' | 'NETSUITE' | 'SALESFORCE' | 'SAGE_INTACCT' | 'RILLET' | 'CAMPFIRE' | 'CHARTHOP' | 'RIPPLING' | 'GOOGLE' | 'OKTA' | 'BOOMI' | 'SAML' | 'OPEN_EXCHANGE_RATES' | 'NETSUITE_RATES' | 'MERGE', required — * `METABASE` - Metabase * `QUICKBOOKS` - QuickBooks * `XERO` - Xero * `NETSUITE` - NetSuite * `SALESFORCE` - Salesforce * `SAGE_INTACCT` - Sage Intacct * `RILLET` - Rillet * `CAMPFIRE` - Campfire * `CHARTHOP` - ChartHop * `RIPPLING` - Rippling * `GOOGLE` - Google SSO * `OKTA` - Okta (OIDC) * `BOOMI` - Boomi * `SAML` - SAML * `OPEN_EXCHANGE_RATES` - Open Exchange Rates * `NETSUITE_RATES` - NetSuite Saved Search * `MERGE` - Cube Universal Connect
    - `category` 'BI' | 'GL' | 'HRIS' | 'SSO' | 'CRM' | 'OTHER' | 'UAP', required — * `BI` - Business Intelligence * `GL` - General Ledger * `HRIS` - Human Resource Information Service * `SSO` - Single Sign On * `CRM` - Customer Relationship Management * `OTHER` - Other * `UAP` - Unified API Platform
    - `name` string, required
    - `logo_url` string, nullable, required
  - `company` Company, required — A serializer mixin that allows dynamic inclusion or exclusion of serializer fields by passing `fields=[...]` or `exclude_fields=[...]` when initializing.
    - `id` string, uuid, required
    - `name` string, required
    - `slug` string, nullable, required
    - `salesforce_id` string, nullable
    - `time_type` 'STANDARD' | 'HALF_YEAR' | 'CUSTOM' — * `STANDARD` - Standard * `HALF_YEAR` - Half Year * `CUSTOM` - Custom
    - `created_at` string, date-time, required
  - `integration_id` integer
  - `company_id` string, uuid
  - `settings` unknown

## Response `201`

- CompanyIntegration — A serializer mixin that allows dynamic inclusion or exclusion of serializer fields by passing `fields=[...]` or `exclude_fields=[...]` when initializing.
  - `id` string, uuid, required
  - `integration` Integration, required
    - `id` integer, required
    - `source` 'METABASE' | 'QUICKBOOKS' | 'XERO' | 'NETSUITE' | 'SALESFORCE' | 'SAGE_INTACCT' | 'RILLET' | 'CAMPFIRE' | 'CHARTHOP' | 'RIPPLING' | 'GOOGLE' | 'OKTA' | 'BOOMI' | 'SAML' | 'OPEN_EXCHANGE_RATES' | 'NETSUITE_RATES' | 'MERGE', required — * `METABASE` - Metabase * `QUICKBOOKS` - QuickBooks * `XERO` - Xero * `NETSUITE` - NetSuite * `SALESFORCE` - Salesforce * `SAGE_INTACCT` - Sage Intacct * `RILLET` - Rillet * `CAMPFIRE` - Campfire * `CHARTHOP` - ChartHop * `RIPPLING` - Rippling * `GOOGLE` - Google SSO * `OKTA` - Okta (OIDC) * `BOOMI` - Boomi * `SAML` - SAML * `OPEN_EXCHANGE_RATES` - Open Exchange Rates * `NETSUITE_RATES` - NetSuite Saved Search * `MERGE` - Cube Universal Connect
    - `category` 'BI' | 'GL' | 'HRIS' | 'SSO' | 'CRM' | 'OTHER' | 'UAP', required — * `BI` - Business Intelligence * `GL` - General Ledger * `HRIS` - Human Resource Information Service * `SSO` - Single Sign On * `CRM` - Customer Relationship Management * `OTHER` - Other * `UAP` - Unified API Platform
    - `name` string, required
    - `logo_url` string, nullable, required
  - `company` Company, required — A serializer mixin that allows dynamic inclusion or exclusion of serializer fields by passing `fields=[...]` or `exclude_fields=[...]` when initializing.
    - `id` string, uuid, required
    - `name` string, required
    - `slug` string, nullable, required
    - `salesforce_id` string, nullable
    - `time_type` 'STANDARD' | 'HALF_YEAR' | 'CUSTOM' — * `STANDARD` - Standard * `HALF_YEAR` - Half Year * `CUSTOM` - Custom
    - `created_at` string, date-time, required
  - `integration_id` integer
  - `company_id` string, uuid
  - `settings` unknown

---

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