> ## Documentation Index > Fetch the complete documentation index at: https://developer.fabric.inc/llms.txt > Use this file to discover all available pages before exploring further. # Create segment > Create a segment to group a specific set of customers. By segmenting customers, you can gain insight into which products are popular among different customer segments, and can create targeted retention strategies. You can also create targeted marketing campaigns that can result in higher conversion rates and increased sales. ## OpenAPI ````yaml segments.openapi post /segments openapi: 3.0.0 info: title: Offers - Segments description: >- Segmentation is a way of grouping customers who share similar characteristics. They may be grouped in a number of ways such as, age group, demographics, location, device type, etc. After creating a segment of customers, you can target promotions to a specific customer segment by linking the promotion to a segment identifier. version: 3.0.0 x-audience: external-public termsOfService: https://fabric.inc/terms-of-use contact: name: Offers support email: support@fabric.inc license: name: fabric API License url: https://fabric.inc/api-license servers: - url: https://api.fabric.inc/v3 description: Production environment security: [] externalDocs: description: Find out more about Offers url: https://developer.fabric.inc/docs/offers-overview paths: /segments: post: tags: - Segments summary: Create segment description: >- Create a segment to group a specific set of customers. By segmenting customers, you can gain insight into which products are popular among different customer segments, and can create targeted retention strategies. You can also create targeted marketing campaigns that can result in higher conversion rates and increased sales. operationId: createSegment parameters: - $ref: '#/components/parameters/xFabricTenantId' - $ref: '#/components/parameters/xFabricChannelId' - $ref: '#/components/parameters/xClientId' - $ref: '#/components/parameters/xFabricRequestId' requestBody: content: application/json: schema: $ref: '#/components/schemas/createSegmentRequest' responses: '201': description: Created headers: x-fabric-request-id: $ref: '#/components/headers/xFabricRequestIdResponse' content: application/json: schema: $ref: '#/components/schemas/createSegmentResponse' '400': description: Bad request headers: x-fabric-request-id: $ref: '#/components/headers/xFabricRequestIdResponse' content: application/json: schema: anyOf: - $ref: '#/components/schemas/segmentNameExist' - $ref: '#/components/schemas/segmentNameNotValid' - $ref: '#/components/schemas/missingTenantHeader' - $ref: '#/components/schemas/error400' '401': description: Unauthorized headers: x-fabric-request-id: $ref: '#/components/headers/xFabricRequestIdResponse' content: application/json: schema: $ref: '#/components/schemas/error401' '500': description: Internal server error headers: x-fabric-request-id: $ref: '#/components/headers/xFabricRequestIdResponse' content: application/json: schema: $ref: '#/components/schemas/error500' security: - AuthorizationToken: [] components: parameters: xFabricTenantId: in: header name: x-fabric-tenant-id schema: type: string minLength: 24 maxLength: 24 required: true example: 5f328bf0b5f328bf0b5f328b description: >- A header used by fabric to identify the tenant making the request. You must include tenant id in the authentication header for an API request to access any of fabric’s endpoints. You can retrieve the tenant id , which is also called account id, from [Copilot](/v3/platform/settings/account-details/getting-the-account-id). This header is required. xFabricChannelId: in: header name: x-fabric-channel-id schema: type: string example: '12' description: >- x-fabric-channel-id identifies the sales channel where the API request is being made; primarily for multichannel use cases. The channel ids are 12 corresponding to US and 13 corresponding to Canada. The default channel id is 12. This field is required. xClientId: in: header name: x-client-id schema: type: string required: false example: copilot description: >- A unique identifier obtained from [Copilot](/v3/platform/settings/api-apps/getting-system-app-credentials) for the System app in the fabric ecosystem, essential for OpenID Connect authentication flows. xFabricRequestId: in: header name: x-fabric-request-id description: A unique request ID. required: false schema: type: string example: 263e731c-45c8-11ed-b878-0242ac120002 schemas: createSegmentRequest: $ref: '#/components/schemas/segmentRequest' createSegmentResponse: $ref: '#/components/schemas/segment' segmentNameExist: type: object description: The error due to duplicate segment name. properties: type: description: The error code. type: string example: SEGMENT_NAME_EXISTS message: description: An error message corresponding to the `type`. type: string example: Segment name already exists segmentNameNotValid: type: object description: The error due to invalid segment. properties: type: description: The error code. type: string example: SEGMENT_NAME_VALUE_CANNOT_BE_EMPTY message: description: An error message corresponding to the `type`. type: string example: Segment name can't be empty missingTenantHeader: type: object description: Tenant header is missing properties: type: description: The error code. type: string example: TENANT_HEADER_REQUIRED message: description: An error message corresponding to the `type`. type: string example: x-fabric-tenant-id header is required error400: type: object description: Bad request error properties: type: description: The error code. type: string example: BAD_REQUEST message: description: An error message corresponding to the `type`. type: string example: Bad request error401: type: object description: Unauthorized error properties: type: description: The error code. type: string example: UNAUTHORIZED message: description: An error message corresponding to the `type`. type: string example: Invalid credentials error500: type: object description: Internal server error properties: type: description: The error code. type: string example: INTERNAL_SERVER_ERROR message: description: An error message corresponding to the `type`. type: string example: Internal server error segmentRequest: type: object description: The details of segment. required: - name - values properties: name: description: The name of the segment type. type: string maxLength: 300 example: Customer Type values: description: The options within a segment type. type: array minItems: 1 maxItems: 50 items: type: string example: High Spender example: - High spender - Medium spender - Browser segment: type: object description: The segment details. required: - id - name - values - createdAt - updatedAt - isDeleted properties: id: description: The segment ID. type: integer format: int32 example: 1000002 name: description: The name of the segment type. type: string example: Spender values: description: The options within a segment type. type: array minItems: 1 maxItems: 50 items: type: string example: High Spender example: - High spender - Medium spender - Browser createdAt: $ref: '#/components/schemas/createdAt' updatedAt: $ref: '#/components/schemas/updatedAt' isDeleted: $ref: '#/components/schemas/isDeleted' createdAt: type: string format: date-time description: Record's creation time example: '2019-08-20T14:15:22.000Z' updatedAt: type: string format: date-time description: Record's last updated time example: '2019-08-20T14:15:22.000Z' isDeleted: type: boolean description: 'true: Record is deleted
false: Record isn''t deleted' example: false headers: xFabricRequestIdResponse: description: Unique request ID schema: type: string example: 263e731c-45c8-11ed-b878-0242ac120002 securitySchemes: AuthorizationToken: type: http scheme: bearer bearerFormat: JWT ````