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

# POST /v1/{+parent}/connectors

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

Creates a new Connector in a given project and location. The operations are validated against and must be compatible with the active schema. If the operations and schema are not compatible or if the schema is not present, this will result in an error.

## Path parameters

- `parent` string, required

## Query parameters

- `connectorId` string
- `requestId` string
- `validateOnly` boolean

## Request body

- Connector — Connector consists of a set of operations, i.e. queries and mutations.
  - `annotations` object — Optional. Stores small amounts of arbitrary data.
  - `updateTime` string, google-datetime — Output only. [Output only] Update time stamp.
  - `reconciling` boolean — Output only. A field that if true, indicates that the system is working to compile and deploy the connector.
  - `displayName` string — Optional. Mutable human-readable name. 63 character limit.
  - `labels` object — Optional. Labels as key value pairs.
  - `etag` string — Output only. 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. [AIP-154](https://google.aip.dev/154)
  - `name` string — Identifier. The relative resource name of the connector, in the format: ``` projects/{project}/locations/{location}/services/{service}/connectors/{connector} ```
  - `createTime` string, google-datetime — Output only. [Output only] Create time stamp.
  - `uid` string — Output only. System-assigned, unique identifier.
  - `source` Source — Used to represent a set of source files.
    - `files` File[] — Required. The files that comprise the source set.
      - `content` string — Required. The file's textual content.
      - `path` string — Required. The file name including folder path, if applicable. The path should be relative to a local workspace (e.g. dataconnect/(schema|connector)/*.gql) and not an absolute path (e.g. /absolute/path/(schema|connector)/*.gql).
  - `clientCache` ClientCache — Client caching settings of a connector.
    - `strictValidationEnabled` boolean — Optional. A field that, if true, enables stricter validation on the connector source code to make sure the operation response shapes are suitable for client-side caching. This can include additional errors and warnings. For example, using the same alias for different fields is disallowed, as it may cause conflicts or confusion with normalized caching. (This field is off by default for compatibility, but enabling it is highly recommended to catch common caching pitfalls.)
    - `entityIdIncluded` boolean — Optional. A field that, if true, means that responses served by this connector will include entityIds in GraphQL response extensions. This helps the client SDK cache responses in an improved way, known as "normalized caching", if caching is enabled on the client. Each entityId is a stable key based on primary key values. Therefore, this field should only be set to true if the primary keys of accessed tables do not contain sensitive information.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/firebasedataconnect.md) · [All operations](https://skmtc.net/google/apis/firebasedataconnect/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/firebasedataconnect/versions/dda665bc52bd/schema)