---
title: "Grants every member of an organization viewer or editor access to an audience."
method: POST
path: "/audience/{audienceId}/shares/organizations"
tags: ["Audience"]
---

# Grants every member of an organization viewer or editor access to an audience.

`POST /audience/{audienceId}/shares/organizations`

## Request

- Base URL: `https://api.rapidata.ai`
- URL: `https://api.rapidata.ai/audience/{audienceId}/shares/organizations`
- Auth: OpenID Connect (`https://auth.rapidata.ai/.well-known/openid-configuration`, scopes: `openid`, `profile`, `email`, `offline_access`, `api`)

The grant follows organization membership, so members who join later inherit the access.
 Granting editor access implies viewing, and lets members manage the audience — including
 starting recruiting, which spends the owner's budget. Re-sharing at the same level is
 idempotent.

## Path parameters

- `audienceId` string, required

## Request body

- ShareAudienceWithOrganizationEndpointInput
  - `organizationId` string, required: The id of the organization to share the audience with.
  - `level` 'Viewer' | 'Editor', required

## Response `204`

No Content

## Other responses

- `400`: Bad Request
- `401`: Unauthenticated
- `403`: Forbidden

## Changes

- **2026-09-04** `9da534659e5f`: 1 info
  - the security scope `api` was added to the endpoint's security scheme `OpenIdConnect`
- **2026-08-31** `f5235270ce3c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rapidata/apis/rapidata-api/changes/audience/:audienceId/shares/organizations/post.md)

---

[API](https://skmtc.dev/rapidata/apis/rapidata-api.md) - [All operations](https://skmtc.dev/rapidata/apis/rapidata-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rapidata/apis/rapidata-api/revisions/52cf3ca9b95f?raw)