> ## Documentation Index
> Fetch the complete documentation index at: https://developers.aimtell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Share Segment

> Shares this segment with one or more additional sites, creating a matching segment on each. Sharing a segment is a prerequisite for sharing any campaign that targets it. Segments using the following conditions cannot be shared: Exists In Segment, Does Not Exist In Segment, Manual Campaign Clicked, Triggered Campaign Clicked, RSS Campaign Clicked. Returns the full shared group, including sites shared previously.



## OpenAPI

````yaml /api-reference/segments-openapi.json post /prod/segment/{id}/shared
openapi: 3.1.0
info:
  title: segmentation
  version: '1.1'
servers:
  - url: https://api.aimtell.com
security:
  - sec0: []
tags:
  - name: Segments
    description: Audience segmentation
  - name: Subscribers
    description: Subscriber management and tracking
paths:
  /prod/segment/{id}/shared:
    post:
      tags:
        - Segments
      summary: Share Segment
      description: >-
        Shares this segment with one or more additional sites, creating a
        matching segment on each. Sharing a segment is a prerequisite for
        sharing any campaign that targets it. Segments using the following
        conditions cannot be shared: Exists In Segment, Does Not Exist In
        Segment, Manual Campaign Clicked, Triggered Campaign Clicked, RSS
        Campaign Clicked. Returns the full shared group, including sites shared
        previously.
      operationId: share-segment
      parameters:
        - name: id
          in: path
          description: Segment ID
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - sites
              properties:
                sites:
                  type: array
                  description: >-
                    Site IDs to share with. Sites the segment already reaches
                    are ignored.
                  items:
                    type: integer
            examples:
              Request:
                value:
                  sites:
                    - 456
                    - 457
                    - 458
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value:
                    - idsegment: 123
                      idSite: 456
                      shared_id: exampleSharedId
                    - idsegment: 124
                      idSite: 457
                      shared_id: exampleSharedId
                    - idsegment: 125
                      idSite: 458
                      shared_id: exampleSharedId
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Result:
                  value:
                    result: error
                    message: Must specify sites
      deprecated: false
components:
  securitySchemes:
    sec0:
      type: apiKey
      name: X-Authorization-Api-Key
      in: header
      x-default: ''

````