> ## Documentation Index > Fetch the complete documentation index at: https://www.c1.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Create > Create a configured connector. ## OpenAPI ````yaml https://spec.speakeasy.com/conductor-one/conductorone/my-source-with-code-samples post /api/v1/apps/{app_id}/connectors/create openapi: 3.1.0 info: description: The C1 API is a HTTP API for managing C1 resources. title: C1 API version: 0.1.0-alpha servers: - description: The C1 API server for the current tenant. url: https://{tenantDomain}.conductor.one variables: tenantDomain: default: example description: The domain of the tenant to use for this request. security: - bearerAuth: [] oauth: [] paths: /api/v1/apps/{app_id}/connectors/create: post: tags: - Connector summary: Create description: Create a configured connector. operationId: c1.api.app.v1.ConnectorService.Create parameters: - in: path name: app_id required: true schema: description: The appId field. readOnly: false type: string requestBody: content: application/json: schema: $ref: >- #/components/schemas/c1.api.app.v1.ConnectorServiceCreateRequestInput responses: '200': content: application/json: schema: $ref: >- #/components/schemas/c1.api.app.v1.ConnectorServiceCreateResponse description: >- The ConnectorServiceCreateResponse is the response returned from creating a connector. x-codeSamples: - lang: go label: Create source: "package main\n\nimport(\n\t\"context\"\n\t\"github.com/conductorone/conductorone-sdk-go/pkg/models/shared\"\n\tconductoronesdkgo \"github.com/conductorone/conductorone-sdk-go\"\n\t\"github.com/conductorone/conductorone-sdk-go/pkg/models/operations\"\n\t\"log\"\n)\n\nfunc main() {\n ctx := context.Background()\n\n s := conductoronesdkgo.New(\n conductoronesdkgo.WithSecurity(shared.Security{\n BearerAuth: \"\",\n Oauth: \"\",\n }),\n )\n\n res, err := s.Connector.Create(ctx, operations.C1APIAppV1ConnectorServiceCreateRequest{\n AppID: \"\",\n })\n if err != nil {\n log.Fatal(err)\n }\n if res.ConnectorServiceCreateResponse != nil {\n // handle response\n }\n}" - lang: typescript label: Typescript (SDK) source: >- import { ConductoroneSDKTypescript } from "conductorone-sdk-typescript"; const conductoroneSDKTypescript = new ConductoroneSDKTypescript({ security: { bearerAuth: "", oauth: "", }, }); async function run() { const result = await conductoroneSDKTypescript.connector.create({ appId: null, }); console.log(result); } run(); components: schemas: c1.api.app.v1.ConnectorServiceCreateRequestInput: description: The ConnectorServiceCreateRequest message. properties: catalogId: description: The catalogId field. readOnly: false type: string config: additionalProperties: true description: >- Contains an arbitrary serialized message along with a @type that describes the type of the serialized message. properties: '@type': description: The type of the serialized message. type: string readOnly: false type: object description: description: The description field. readOnly: false type: string expandMask: $ref: '#/components/schemas/c1.api.app.v1.ConnectorExpandMask' userIds: description: The userIds field. items: type: string nullable: true readOnly: false type: array title: Connector Service Create Request type: object x-speakeasy-name-override: ConnectorServiceCreateRequest c1.api.app.v1.ConnectorServiceCreateResponse: description: >- The ConnectorServiceCreateResponse is the response returned from creating a connector. properties: connectorView: $ref: '#/components/schemas/c1.api.app.v1.ConnectorView' expanded: description: The array of expanded items indicated by the request. items: additionalProperties: true description: >- Contains an arbitrary serialized message along with a @type that describes the type of the serialized message. properties: '@type': description: The type of the serialized message. type: string readOnly: false type: object nullable: true readOnly: false type: array title: Connector Service Create Response type: object x-speakeasy-name-override: ConnectorServiceCreateResponse c1.api.app.v1.ConnectorExpandMask: description: >- The ConnectorExpandMask is used to expand related objects on a connector. properties: paths: description: >- Paths that you want expanded in the response. Possible values are "app_id" and "*". items: type: string nullable: true readOnly: false type: array title: Connector Expand Mask type: object x-speakeasy-name-override: ConnectorExpandMask c1.api.app.v1.ConnectorView: description: >- The ConnectorView object provides a connector response object, as well as JSONPATHs to related objects provided by expanders. properties: appPath: description: >- JSONPATH expression indicating the location of the App object in the expanded array. readOnly: false type: string capabilitiesPath: description: >- JSONPATH expression indicating the location of the ConnectorCapabilities object in the expanded array. readOnly: false type: string connector: $ref: '#/components/schemas/c1.api.app.v1.Connector' usersPath: description: >- JSONPATH expression indicating the location of the User object in the expanded array. This is the user that is a direct target of the ticket without a specific relationship to a potentially non-existent app user. readOnly: false type: string title: Connector View type: object x-speakeasy-name-override: ConnectorView c1.api.app.v1.Connector: description: A Connector is used to sync objects into Apps properties: appId: description: The id of the app the connector is associated with. readOnly: false type: string canResumeSync: description: The canResumeSync field. readOnly: false type: boolean catalogId: description: >- The catalogId describes which catalog entry this connector is an instance of. For example, every Okta connector will have the same catalogId indicating it is an Okta connector. readOnly: false type: string config: additionalProperties: true description: >- Contains an arbitrary serialized message along with a @type that describes the type of the serialized message. properties: '@type': description: The type of the serialized message. type: string readOnly: false type: object configUpdatedAt: format: date-time readOnly: true type: string connectorApiVersion: description: The connectorApiVersion field. format: uint32 readOnly: true type: integer connectorSyncCronSchedule: $ref: '#/components/schemas/c1.api.app.v1.ConnectorSyncCronSchedule' createdAt: format: date-time readOnly: true type: string deletedAt: format: date-time readOnly: true type: string description: description: The description of the connector. readOnly: false type: string disableCheckBadSync: description: The disableCheckBadSync field. readOnly: false type: boolean displayName: description: The display name of the connector. readOnly: false type: string downloadUrl: description: >- The downloadUrl for a spreadsheet if the connector was created from uploading a file. readOnly: true type: string id: description: The id of the connector. readOnly: false type: string oauthAuthorizedAs: $ref: '#/components/schemas/c1.api.app.v1.OAuth2AuthorizedAs' parallelSyncWorkerCount: description: >- Number of sync workers to use for parallel sync, when the PARALLEL_SYNC feature is enabled. Zero disables parallel sync. Optional on write: omit the field in UpdateAdvancedConfig to leave the stored value unchanged. The public API allows setting up to 4. format: int32 nullable: true readOnly: false type: integer profileAllowList: description: >- List of profile attributes to sync, when set only these attributes will be synced items: type: string nullable: true readOnly: false type: array profileIgnoreList: description: >- List of profile attributes to ignore (not sync), when set other attributes will be synced, but these will not. items: type: string nullable: true readOnly: false type: array status: $ref: '#/components/schemas/c1.api.app.v1.ConnectorStatus' syncConfig: $ref: '#/components/schemas/c1.api.app.v1.SyncConfig' syncDisabledAt: format: date-time readOnly: true type: string syncDisabledCategory: description: The category of the connector sync that was disabled. readOnly: false type: string syncDisabledReason: description: The reason the connector sync was disabled. readOnly: false type: string updatedAt: format: date-time readOnly: true type: string userIds: description: >- The userIds field is used to define the integration owners of the connector. items: type: string nullable: true readOnly: false type: array title: Connector type: object x-speakeasy-name-override: Connector c1.api.app.v1.ConnectorSyncCronSchedule: description: The ConnectorSyncCronSchedule message. properties: cronSpec: description: The cronSpec field. readOnly: false type: string start: format: date-time readOnly: false type: string timezone: description: The timezone field. readOnly: false type: string title: Connector Sync Cron Schedule type: object x-speakeasy-name-override: ConnectorSyncCronSchedule c1.api.app.v1.OAuth2AuthorizedAs: description: OAuth2AuthorizedAs tracks the user that OAuthed with the connector. properties: authEmail: description: >- authEmail is the email of the user that authorized the connector using OAuth. readOnly: true type: string authorizedAt: format: date-time readOnly: true type: string title: O Auth 2 Authorized As type: object x-speakeasy-name-override: OAuth2AuthorizedAs c1.api.app.v1.ConnectorStatus: description: >- The status field on the connector is used to track the status of the connectors sync, and when syncing last started, completed, or caused the connector to update. properties: completedAt: format: date-time readOnly: false type: string lastError: description: The last error encountered by the connector. readOnly: false type: string startedAt: format: date-time readOnly: false type: string status: description: The status of the connector sync. enum: - SYNC_STATUS_UNSPECIFIED - SYNC_STATUS_RUNNING - SYNC_STATUS_DONE - SYNC_STATUS_ERROR - SYNC_STATUS_DISABLED readOnly: false type: string x-speakeasy-unknown-values: allow updatedAt: format: date-time readOnly: false type: string title: Connector Status type: object x-speakeasy-name-override: ConnectorStatus c1.api.app.v1.SyncConfig: description: The SyncConfig message. properties: syncResourceTypeIds: description: The syncResourceTypeIds field. items: type: string nullable: true readOnly: false type: array title: Sync Config type: object x-speakeasy-name-override: SyncConfig securitySchemes: bearerAuth: scheme: bearer type: http oauth: description: >- This API uses OAuth2 with the Client Credential flow. Client Credentials must be sent in the BODY, not the headers. For an example of how to implement this, refer to the [c1TokenSource.Token()](https://github.com/ConductorOne/conductorone-sdk-go/blob/3375fe7c0126d17e7ec4e711693dee7b791023aa/token_source.go#L101-L187) function. flows: clientCredentials: scopes: {} tokenUrl: /auth/v1/token type: oauth2 ````