---
title: "Configure connector resources"
method: POST
path: "/connectors/{id}/configure"
tags: ["connectors"]
---

# Configure connector resources

`POST /connectors/{id}/configure`

Save the selected resources for a connector and trigger initial sync/backfill.

## Path parameters

- `id` string, required

## Request body

- HandlerConfigureReq
  - `backfill_chunk_interval_seconds` integer — Internal interval for async backfill paging.
  - `lookback_days` integer — How far back the first sync fetches historical data. Only applies to the initial sync — subsequent syncs are incremental from the last cursor.
  - `resources` HandlerResourceMapping[], required — Resources to activate for this connector. Each item corresponds to one entry from the Discover endpoint.
    - `additional_metadata` object — AdditionalMetadata is merged into the additional_metadata layer of every object synced from this resource. Provider-generated fields take precedence.
    - `collection` string — Collection is the canonical v2 name for the per-resource sub-tenant override: routes synced objects from this resource into a specific collection. Empty means the resource inherits the connector collection. SubTenantID is the deprecated alias for this field, reconciled by Configure before toResource runs.
    - `database` string — Database is the canonical v2 name for the per-resource tenant override: routes synced objects from this resource into a specific database. Empty means the resource inherits the connector database. TenantID is the deprecated alias for this field, reconciled by Configure before toResource runs.
    - `metadata` object — Metadata is merged into the tenant metadata layer of every object synced from this resource. System fields (connector_id, provider) take precedence.
    - `name` string — Display name for this resource.
    - `resource_id` string, required — Resource identifier from the Discover endpoint.
    - `resource_type` string — Type of resource within the provider (e.g. `channel`, `repo`, `linear_team`).
    - `sub_tenant_id` string — Routes synced objects from this resource into a specific sub-tenant partition. Overrides the connector-level sub_tenant_id. Deprecated: use collection.
    - `tenant_id` string — Optional per-resource tenant override (for "route specific resources to different tenants"). Empty means the resource inherits the connector tenant. Deprecated: use database.

## Response `200`

OK

- object

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `500` — Internal Server Error

---

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