---
title: "Create a Connector"
method: POST
path: "/v3/connectors"
tags: ["Connectors"]
---

# Create a Connector

`POST /v3/connectors`

## Request body

- ConnectorCreateRequestV3 — Request body to create a connector.
  - `type` 'box' | 'paragon', required — Connector type.
  - `name` string, required — Human-friendly name for this connector.
  - `workflowID` string — One of `workflowID` or `workflowName` must be provided. If both are provided, they must refer to the same workflow.
  - `workflowName` string — One of `workflowID` or `workflowName` must be provided. If both are provided, they must refer to the same workflow.
  - `boxClientID` string — Box client ID (from your Box application).
  - `boxClientSecret` string — Box client secret (from your Box application).
  - `boxEnterpriseID` string — Box enterprise ID.
  - `boxFolderID` string — Box folder ID to watch for new uploads.
  - `paragonIntegration` string — Paragon integration, eg. "googledrive".
  - `paragonConfiguration` object — Configuration specific to the type of integration.

## Response `200`

The request has succeeded.

- ConnectorV3 — A Connector represents an integration that triggers a Bem workflow from an external system.
  - `type` 'box' | 'paragon', required — Connector type.
  - `connectorID` string, required — Unique identifier for the connector.
  - `name` string, required — Human-friendly name for this connector.
  - `workflowID` string, required — Workflow API ID that will be triggered by this connector.
  - `workflowName` string, required — Workflow name that will be triggered by this connector.
  - `boxClientID` string, required — Box client ID (from your Box application).
  - `boxClientSecret` string, required — Box client secret (from your Box application). Note: This value is sensitive and should be stored securely.
  - `boxEnterpriseID` string, required — Box enterprise ID.
  - `boxFolderID` string, required — Box folder ID to watch for new uploads.
  - `paragonSyncID` string, required — Paragon sync ID.
  - `paragonIntegration` string, required — Paragon integration, eg. "googledrive".
  - `paragonConfiguration` object, required — Configuration specific to the type of integration.

---

[API](https://skmtc.dev/bem-team/apis/bem-api.md) · [All operations](https://skmtc.dev/bem-team/apis/bem-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bem-team/bem-api/revisions/a6e4624117c6/schema)