# Shared connections

A shared connection lets several organizations in one environment sign in through one identity provider connection: for example, the subsidiaries of a group that runs a single Okta tenant.

- `POST /v1/connections/{conn}/shares` shares the owning organization's connection with another `organization`, with the `routing_domains` that send users there. `owner_consent: true` records that the owning organization agreed.
- `GET /v1/connections/{conn}/shares` lists shares.
- `DELETE /v1/connections/{conn}/shares/{share}` revokes one. Revocation applies to the next sign-in.

Sign-ins through a shared connection are routed to the right organization by the user's email domain. Events: `connection.shared` and `connection.share_revoked`. An invalid share request answers [`connection_share_invalid`](/errors/connection_share_invalid/). Terraform: `ohauthcat_connection_share`.
