---
updatedAt: 2026-01-24T15:55:14.000Z
agentTools:
  projectIndex: https://docs.checkhq.com/llms.txt
---

# Authorize integration

This Component allows employers to authorize an integration partner to access their data in Check.

<Image align="center" border={false} src="https://files.readme.io/b9b030b9b16dfc56e467ab6ea6a9c7574e2c9b0fa774119e38425fb365c03e9f-Screenshot_2026-01-24_at_10.49.07_AM.png" />

<br />

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "check-api",
    "version": "2025-01-01"
  },
  "servers": [
    {
      "url": "https://sandbox.checkhq.com"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "in": "header",
        "name": "Authorization",
        "x-bearer-format": "bearer",
        "x-default": "YOUR_API_KEY"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/companies/{company}/components/integrations/authorize": {
      "post": {
        "summary": "Copy of Company Accounting Integration",
        "description": "This Component allows employers to sync accounting data with Check. Currently, we only support integrations with Quickbooks Online.\n\nThe Accounting Integration Component is disabled by default for all companies. Please reach out to us to enable it for specific companies or for all of your companies.\n<img style=\"margin-top: 30px; margin-bottom: 20px;\" src=\"https://public-component-assets.s3.amazonaws.com/er_accounting_integration.svg\" />\nLearn how to embed Components in our <a target=\"_blank\" href=\"https://docs.checkhq.com/docs/embedding-a-component\">guide</a>.",
        "operationId": "company-accounting-integration-1",
        "parameters": [
          {
            "name": "company",
            "in": "path",
            "description": "ID of the company for which a component link will be generated",
            "schema": {
              "type": "string"
            },
            "required": true
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\"url\":\"{component_url}\"}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "url": {
                      "type": "string",
                      "example": "{component_url}"
                    }
                  },
                  "required": [
                    "url"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false,
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "integration_partner": {
                    "type": "string",
                    "default": "",
                    "description": "ID of the integration partner you want to authorize"
                  },
                  "integration_permission": {
                    "type": "string",
                    "default": "",
                    "description": "ID of the integration permission you want to grant for this company"
                  },
                  "email": {
                    "type": "string",
                    "default": "",
                    "description": "Email of the user granting permission"
                  },
                  "redirect_url": {
                    "type": "string",
                    "default": "",
                    "description": "The URL you want the component to return the user to once authorization is complete"
                  }
                },
                "required": [
                  "integration_partner",
                  "integration_permission",
                  "email"
                ]
              }
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```