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

# Create a price list and entries

> Creates a price list with entries and optionally assigns it to partnerships (buyers). Idempotent via Idempotency-Key.



## OpenAPI

````yaml openapi.json post /api/v1/pricing
openapi: 3.0.3
info:
  title: Polinate External API
  version: 1.0.0
  description: >-
    External API for partners and services. Authentication via X-Business-Id and
    X-API-Key headers.


    Credentials location: In the Polinate app, navigate to Business Settings →
    Integrations to find your Business ID and API Key.
servers:
  - url: https://integrations.polinate.ai
    description: Production
security: []
tags:
  - name: Items
    description: >-
      Manage items and item variants. Auth: X-Business-Id and X-API-Key (see
      Business Settings → Integrations).
  - name: Buyers
    description: >-
      Create buyers and related contacts/locations. Auth: X-Business-Id and
      X-API-Key (see Business Settings → Integrations).
  - name: Pricing
    description: >-
      Create price lists and entries. Auth: X-Business-Id and X-API-Key (see
      Business Settings → Integrations).
  - name: Invoices
    description: >-
      List and update invoices. Auth: X-Business-Id and X-API-Key (see Business
      Settings → Integrations).
  - name: Orders
    description: >-
      Order ingestion. Auth: X-Business-Id and X-API-Key (see Business Settings
      → Integrations).
paths:
  /api/v1/pricing:
    post:
      tags:
        - Pricing
      summary: Create a price list and entries
      description: >-
        Creates a price list with entries and optionally assigns it to
        partnerships (buyers). Idempotent via Idempotency-Key.
      operationId: createPricing
      parameters:
        - schema:
            type: string
            description: >-
              Business identifier for external auth. Find in Polinate app →
              Business Settings → Integrations.
            example: '{{businessId}}'
          required: true
          name: X-Business-Id
          in: header
        - schema:
            type: string
            description: >-
              Per-business API key for external auth. Find in Polinate app →
              Business Settings → Integrations.
            example: '{{apiKey}}'
          required: true
          name: X-API-Key
          in: header
        - schema:
            type: string
            description: Idempotency key for POST operations
            example: '{{idempotencyKey}}'
          required: false
          name: Idempotency-Key
          in: header
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                itemListData:
                  type: object
                  properties:
                    label:
                      type: string
                      description: Must be unique per supplier business
                    status:
                      type: string
                      enum:
                        - DRAFT
                        - ACTIVE
                        - ARCHIVED
                    startDate:
                      type: string
                      nullable: true
                      format: date-time
                    endDate:
                      type: string
                      nullable: true
                      format: date-time
                    globalPriceFactor:
                      type: number
                      nullable: true
                    globalCostFactor:
                      type: number
                      nullable: true
                  required:
                    - label
                  additionalProperties: false
                entries:
                  type: array
                  items:
                    type: object
                    properties:
                      itemVariantId:
                        type: string
                        description: Cannot repeat for the same list
                      currency:
                        type: string
                        enum:
                          - USD
                          - EUR
                          - GBP
                          - CAD
                          - AUD
                          - NZD
                          - CHF
                          - JPY
                          - CNY
                          - INR
                          - BRL
                          - MXN
                          - ARS
                          - COP
                          - PHP
                      overrideFlatPrice:
                        type: number
                      overrideFlatCost:
                        type: number
                      overridePriceFactor:
                        type: number
                      overrideCostFactor:
                        type: number
                      label:
                        type: string
                    required:
                      - itemVariantId
                    additionalProperties: false
                  minItems: 1
                partnerships:
                  type: array
                  items:
                    type: string
                  default: []
              required:
                - itemListData
                - entries
            example:
              itemListData:
                label: Winter 2025
                status: ACTIVE
                globalPriceFactor: 1.05
                globalCostFactor: 0.95
                startDate: '2025-06-01T00:00:00Z'
                endDate: '2025-08-31T23:59:59Z'
              entries:
                - itemVariantId: var_123
                  overrideFlatPrice: 10
                  currency: AUD
              partnerships:
                - prt_123
      responses:
        '200':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PricingCreateResponse'
              example:
                success: true
        '400':
          description: Invalid payload
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardError'
        '429':
          description: Rate limited
          headers:
            Retry-After:
              schema:
                type: string
              description: Seconds to wait before retrying
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardError'
components:
  schemas:
    PricingCreateResponse:
      type: object
      properties:
        success:
          type: boolean
      required:
        - success
    StandardError:
      type: object
      properties:
        errorCode:
          type: string
        message:
          type: string
        fieldErrors:
          type: object
          additionalProperties:
            type: string
      required:
        - errorCode
        - message

````