---
title: "POST /v1/{+parent}/accountConnectors"
method: POST
path: "/v1/{+parent}/accountConnectors"
tags: ["projects"]
---

# POST /v1/{+parent}/accountConnectors

`POST /v1/{+parent}/accountConnectors`

Creates a new AccountConnector in a given project and location.

## Path parameters

- `parent` string, required

## Query parameters

- `accountConnectorId` string
- `requestId` string
- `validateOnly` boolean

## Request body

- AccountConnector — AccountConnector encapsulates what a platform administrator needs to configure for users to connect to the service providers, which includes, among other fields, the OAuth client ID, client secret, and authorization and token endpoints.
  - `customOauthConfig` CustomOAuthConfig — Message for a customized OAuth config.
    - `sslCaCertificate` string — Optional. SSL certificate to use for requests to a private service.
    - `authUri` string — Required. Immutable. The OAuth2 authorization server URL.
    - `clientId` string — Required. The client ID of the OAuth application.
    - `clientSecret` string — Required. Input only. The client secret of the OAuth application. It will be provided as plain text, but encrypted and stored in developer connect. As INPUT_ONLY field, it will not be included in the output.
    - `scopes` string[] — Required. The scopes to be requested during OAuth.
    - `serviceDirectoryConfig` ServiceDirectoryConfig — ServiceDirectoryConfig represents Service Directory configuration for a connection.
      - `service` string — Required. The Service Directory service name. Format: projects/{project}/locations/{location}/namespaces/{namespace}/services/{service}.
    - `hostUri` string — Required. The host URI of the OAuth application.
    - `serverVersion` string — Output only. SCM server version installed at the host URI.
    - `tokenUri` string — Required. Immutable. The OAuth2 token request URL.
    - `pkceDisabled` boolean — Optional. Disable PKCE for this OAuth config. PKCE is enabled by default.
    - `scmProvider` 'SCM_PROVIDER_UNKNOWN' | 'GITHUB_ENTERPRISE' | 'GITLAB_ENTERPRISE' | 'BITBUCKET_DATA_CENTER' — Required. The type of the SCM provider.
  - `oauthStartUri` string — Output only. Start OAuth flow by clicking on this URL.
  - `uid` string — Output only. A system-assigned unique identifier for the Account Connector.
  - `updateTime` string, google-datetime — Output only. The timestamp when the accountConnector was updated.
  - `etag` string — Optional. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.
  - `labels` object — Optional. Labels as key value pairs
  - `providerOauthConfig` ProviderOAuthConfig — ProviderOAuthConfig is the OAuth config for a provider.
    - `systemProviderId` 'SYSTEM_PROVIDER_UNSPECIFIED' | 'GITHUB' | 'GITLAB' | 'GOOGLE' | 'SENTRY' | 'ROVO' | 'NEW_RELIC' | 'DATASTAX' | 'DYNATRACE' — Optional. Immutable. Developer Connect provided OAuth.
    - `scopes` string[] — Required. User selected scopes to apply to the Oauth config In the event of changing scopes, user records under AccountConnector will be deleted and users will re-auth again.
  - `name` string — Identifier. The resource name of the accountConnector, in the format `projects/{project}/locations/{location}/accountConnectors/{account_connector_id}`.
  - `annotations` object — Optional. Allows users to store small amounts of arbitrary data.
  - `createTime` string, google-datetime — Output only. The timestamp when the accountConnector was created.
  - `proxyConfig` ProxyConfig — The proxy configuration.
    - `httpProxyBaseUri` string — Output only. The base URI for the HTTP proxy endpoint. Has the format `https://{generatedID}-a-h-{shortRegion}.developerconnect.dev` Populated only when `enabled` is set to `true`. This endpoint is used by other Google services that integrate with Developer Connect.
    - `enabled` boolean — Optional. Setting this to true allows the git and http proxies to perform actions on behalf of the user configured under the account connector.

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/developerconnect.md) · [All operations](https://skmtc.dev/google/apis/developerconnect/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/developerconnect/revisions/2526b3369dcc/schema)