Conga

Conga Price Programs API

The Price Programs API from Conga — 2 operation(s) for price programs.

GitHub OpenAPI
Business capability
Discount & Promotion Management BC-440.30

Operations 7

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

DELETE /price-programs Delete several incentives at once · Delete incentives #
Ask an LLM
“How can I bulk delete multiple incentives?”
“Is there a way to remove many price programs in a single request?”
Tell an agent destructive · confirm first
Bulk delete several price program incentives.
Remove multiple incentives in one request.
GET /price-programs List price program incentives · Retrieve incentives #
Ask an LLM
“How do I see all the price program incentives set up in Conga CPQ?”
“Can I filter and sort the list of incentives?”
Tell an agent
List all price program incentives.
Show incentives matching {filter}, sorted by {sort}.
PATCH /price-programs Update several incentives at once · Update incentives #
Ask an LLM
“Can I update many incentives together in one bulk call?”
“What's the quickest way to change several price programs at the same time?”
Tell an agent
Bulk update several price program incentives.
Apply changes to multiple incentives in one request.
POST /price-programs Create several incentives at once · Create incentives #
Ask an LLM
“What's the way to create several new incentives in a single request?”
“Can I set up multiple price programs in bulk?”
Tell an agent
Create a batch of new price program incentives.
Set up several new incentives in one call.
DELETE /price-programs/{Id} Delete one incentive · Delete an incentive #
Ask an LLM
“How do I delete a single incentive by its ID?”
“Can I remove just one price program without affecting the others?”
Tell an agent destructive · confirm first
Delete incentive {Id}.
Remove only price program {Id}.
GET /price-programs/{Id} Get one incentive by ID · Retrieve an incentive #
Ask an LLM
“How do I look up a single incentive by its identifier?”
“Can I include related records when fetching one price program?”
Tell an agent
Get incentive {Id}.
Show price program {Id} including {includes}.
PATCH /price-programs/{Id} Update one incentive · Update an incentive #
Ask an LLM
“What do I call to change the details of one specific incentive?”
“Can I edit a single price program by its ID?”
Tell an agent
Update incentive {Id}.
Edit just price program {Id}.

Documentation

📖
Authentication
https://raw.githubusercontent.com/api-evangelist/conga/refs/heads/main/authentication/conga-authentication.yml
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/conga/refs/heads/main/rate-limits/conga-rate-limits.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/conga/refs/heads/main/openapi/conga-price-programs-api-openapi.yml

Other Resources

🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/conga/refs/heads/main/data-model/conga-data-model.yml
🔗
OAuthScopes
https://raw.githubusercontent.com/api-evangelist/conga/refs/heads/main/scopes/conga-scopes.yml
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/conga/refs/heads/main/conventions/conga-conventions.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/conga/refs/heads/main/errors/conga-problem-types.yml
🔗
Lifecycle
https://raw.githubusercontent.com/api-evangelist/conga/refs/heads/main/lifecycle/conga-lifecycle.yml
🔗
Conformance
https://raw.githubusercontent.com/api-evangelist/conga/refs/heads/main/conformance/conga-conformance.yml
🔗
Sandbox
https://raw.githubusercontent.com/api-evangelist/conga/refs/heads/main/sandbox/conga-sandbox.yml
🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/conga/refs/heads/main/asyncapi/conga-webhooks.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/conga:conga-price-programs-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

conga-price-programs-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Incentive Administration Price Programs API
  version: 1.0.0
servers:
- url: https://rls.congacloud.com/api/incentive-admin/v1
security:
- Bearer: []
tags:
- name: Price Programs
paths:
  /price-programs:
    delete:
      tags:
      - Price Programs
      summary: Delete incentives
      description: Deletes multiple incentives.
      requestBody:
        description: The list of incentives to delete
        content:
          application/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/Incentive'
            example:
            - Id: Id of the record to delete
          text/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/Incentive'
          application/*+json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/Incentive'
      responses:
        '200':
          description: OK
      operationId: deletePricePrograms
      x-operation-id-source: derived
    get:
      tags:
      - Price Programs
      summary: Retrieve incentives
      description: Retrieves the collection of incentives.
      parameters:
      - name: filter
        in: query
        description: Optional filter parameters
        schema:
          type: array
          items:
            type: string
      - name: sort
        in: query
        description: Optional sort parameter
        schema:
          type: string
      - name: page
        in: query
        description: Page number
        schema:
          type: integer
          format: int32
          default: 1
      - name: limit
        in: query
        description: Number of items per page
        schema:
          type: integer
          format: int32
          default: 50
      - name: includes
        in: query
        description: Optional related entities to include
        schema:
          type: array
          items:
            type: string
      - name: field
        in: query
        description: Pass Comma separated multiple fields
        schema:
          type: array
          items:
            type: string
      - name: filterExpression
        in: query
        description: ''
        schema:
          type: string
      responses:
        '200':
          description: OK
        '204':
          description: No Content
      operationId: getPricePrograms
      x-operation-id-source: derived
    patch:
      tags:
      - Price Programs
      summary: Update incentives
      description: Updates multiple incentives.
      requestBody:
        description: The list of incentives with updated data
        content:
          application/json:
            schema:
              type: array
              items:
                type: object
                additionalProperties: {}
            example:
            - Name: PriceProgramName
              AccountScope:
              - All
              AccountScopeOper: in
              AccountTypeScope:
              - All
              AccountTypeScopeOper: in
              IsActive: true
              AmendmentEffectiveDate: null
              Ancestor: null
              ApplicationMethod: Buy X Get X
              AutoApply: true
              BenefitUom: null
              CombineWithOtherIncentives: false
              ContextType: Line Item
              CountryScope:
              - All
              CountryScopeOper: in
              CycleEndDate: null
              CycleStartDate: null
              Description: Price program description
              Downgrade: null
              EffectiveDate: '2022-10-10'
              EnableBenefitEffectivityDates: false
              ExcludeChildrenWithActivePrograms: false
              ExpirationDate: '2023-10-10'
              IncentiveCode: null
              IncentiveGroup: null
              IncentiveNumber: null
              IncentiveNumberAuto: null
              IncentiveNumberText: null
              IncludeOrdersForAccountHierarchy: false
              IsBundle: false
              Loyalty: null
              MaxPoints: null
              OriginalEffectiveDate: null
              PointAccrualLevel: null
              PriceListScope:
              - All
              PriceListScopeOper: in
              ProductFamilyScope:
              - All
              ProductFamilyScopeOper: in
              ProductGroupScope:
              - All
              ProductGroupScopeOper: in
              ProductScope:
              - All
              ProductScopeOper: in
              RecurrenceFrequency: null
              RegionScope:
              - All
              RegionScopeOper: in
              RenewalEffectiveDate: null
              SearchField: null
              Sequence: 1
              Status: New
              StopProcessingMoreIncentives: false
              SubUseType: Point Accrual
              Upgrade: null
              UseType: Price Program
              VersionNumber: null
              Criteria: null
              ExclusionCriteria: null
              Id: Id of the record
          text/json:
            schema:
              type: array
              items:
                type: object
                additionalProperties: {}
          application/*+json:
            schema:
              type: array
              items:
                type: object
                additionalProperties: {}
      responses:
        '200':
          description: OK
      operationId: patchPricePrograms
      x-operation-id-source: derived
    post:
      tags:
      - Price Programs
      summary: Create incentives
      description: Creates multiple incentives.
      requestBody:
        description: The list of incentives to create
        content:
          application/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/Incentive'
          text/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/Incentive'
          application/*+json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/Incentive'
      responses:
        '200':
          description: OK
      operationId: postPricePrograms
      x-operation-id-source: derived
  /price-programs/{Id}:
    delete:
      tags:
      - Price Programs
      summary: Delete an incentive
      description: Deletes a single incentive by its identifier.
      parameters:
      - name: Id
        in: path
        description: The identifier of the incentive to delete
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
      operationId: deletePriceProgramsById
      x-operation-id-source: derived
    get:
      tags:
      - Price Programs
      summary: Retrieve an incentive
      description: Retrieves a single incentive by its identifier.
      parameters:
      - name: Id
        in: path
        description: The identifier of the incentive
        required: true
        schema:
          type: string
      - name: includes
        in: query
        description: Optional related entities to include
        schema:
          type: array
          items:
            type: string
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/Incentive'
            application/json:
              schema:
                $ref: '#/components/schemas/Incentive'
            text/json:
              schema:
                $ref: '#/components/schemas/Incentive'
        '204':
          description: No Content
      operationId: getPriceProgramsById
      x-operation-id-source: derived
    patch:
      tags:
      - Price Programs
      summary: Update an incentive
      description: Updates a single incentive.
      parameters:
      - name: Id
        in: path
        description: The identifier of the incentive to update
        required: true
        schema:
          type: string
      requestBody:
        description: The updated data of the incentive
        content:
          application/json:
            schema:
              type: object
              additionalProperties: {}
            example:
              Name: PriceProgramName
              AccountScope:
              - All
              AccountScopeOper: in
              AccountTypeScope:
              - All
              AccountTypeScopeOper: in
              IsActive: true
              AmendmentEffectiveDate: null
              Ancestor: null
              ApplicationMethod: Buy X Get X
              AutoApply: true
              BenefitUom: null
              CombineWithOtherIncentives: false
              ContextType: Line Item
              CountryScope:
              - All
              CountryScopeOper: in
              CycleEndDate: null
              CycleStartDate: null
              Description: Price program description
              Downgrade: null
              EffectiveDate: '2022-10-10'
              EnableBenefitEffectivityDates: false
              ExcludeChildrenWithActivePrograms: false
              ExpirationDate: '2023-10-10'
              IncentiveCode: null
              IncentiveGroup: null
              IncentiveNumber: null
              IncentiveNumberAuto: null
              IncentiveNumberText: null
              IncludeOrdersForAccountHierarchy: false
              IsBundle: false
              Loyalty: null
              MaxPoints: null
              OriginalEffectiveDate: null
              PointAccrualLevel: null
              PriceListScope:
              - All
              PriceListScopeOper: in
              ProductFamilyScope:
              - All
              ProductFamilyScopeOper: in
              ProductGroupScope:
              - All
              ProductGroupScopeOper: in
              ProductScope:
              - All
              ProductScopeOper: in
              RecurrenceFrequency: null
              RegionScope:
              - All
              RegionScopeOper: in
              RenewalEffectiveDate: null
              SearchField: null
              Sequence: 1
              Status: New
              StopProcessingMoreIncentives: false
              SubUseType: Point Accrual
              Upgrade: null
              UseType: Price Program
              VersionNumber: null
              Criteria: null
              ExclusionCriteria: null
          text/json:
            schema:
              type: object
              additionalProperties: {}
          application/*+json:
            schema:
              type: object
              additionalProperties: {}
      responses:
        '200':
          description: OK
      operationId: patchPriceProgramsById
      x-operation-id-source: derived
components:
  schemas:
    Incentive:
      type: object
      properties:
        Id:
          type:
          - string
          - 'null'
        Name:
          type:
          - string
          - 'null'
        CreatedBy:
          $ref: '#/components/schemas/LookupObject'
        CreatedDate:
          type: string
          format: date-time
        ModifiedBy:
          $ref: '#/components/schemas/LookupObject'
        ModifiedDate:
          type: string
          format: date-time
        ExternalId:
          type:
          - string
          - 'null'
        ETag:
          type:
          - string
          - 'null'
        AccountScope:
          type:
          - array
          - 'null'
          items:
            type: string
        AccountScopeOper:
          type:
          - string
          - 'null'
        AccountTypeScope:
          type:
          - array
          - 'null'
          items:
            type: string
        AccountTypeScopeOper:
          type:
          - string
          - 'null'
        IsActive:
          type:
          - boolean
          - 'null'
        AmendmentEffectiveDate:
          type:
          - string
          - 'null'
          format: date-time
        Ancestor:
          $ref: '#/components/schemas/LookupObject'
        ApplicationMethod:
          type:
          - string
          - 'null'
        AutoApply:
          type:
          - boolean
          - 'null'
        BenefitUom:
          type:
          - string
          - 'null'
        CascadeBenefitsForBundles:
          type:
          - boolean
          - 'null'
        CombineWithOtherIncentives:
          type:
          - boolean
          - 'null'
        ContextType:
          type:
          - string
          - 'null'
        CountryScope:
          type:
          - array
          - 'null'
          items:
            type: string
        CountryScopeOper:
          type:
          - string
          - 'null'
        CycleEndDate:
          type:
          - string
          - 'null'
          format: date-time
        CycleStartDate:
          type:
          - string
          - 'null'
          format: date-time
        Description:
          type:
          - string
          - 'null'
        Downgrade:
          type:
          - string
          - 'null'
        EffectiveDate:
          type:
          - string
          - 'null'
          format: date-time
        EnableBenefitEffectivityDates:
          type:
          - boolean
          - 'null'
        ExcludeChildrenWithActivePrograms:
          type:
          - boolean
          - 'null'
        ExpirationDate:
          type:
          - string
          - 'null'
          format: date-time
        IncentiveCode:
          type:
          - string
          - 'null'
        IncentiveGroup:
          $ref: '#/components/schemas/LookupObject'
        IncentiveProgram:
          $ref: '#/components/schemas/LookupObject'
        IncentiveNumber:
          type:
          - string
          - 'null'
        IncentiveNumberAuto:
          type:
          - string
          - 'null'
        IncentiveNumberText:
          type:
          - string
          - 'null'
        IncludeOrdersForAccountHierarchy:
          type:
          - boolean
          - 'null'
        IsBundle:
          type:
          - boolean
          - 'null'
        Loyalty:
          $ref: '#/components/schemas/LookupObject'
        MaxPoints:
          type:
          - number
          - 'null'
          format: double
        OriginalEffectiveDate:
          type:
          - string
          - 'null'
          format: date-time
        PointAccrualLevel:
          type:
          - string
          - 'null'
        PriceListScope:
          type:
          - array
          - 'null'
          items:
            type: string
        PriceListScopeOper:
          type:
          - string
          - 'null'
        ProductFamilyScope:
          type:
          - array
          - 'null'
          items:
            type: string
        ProductFamilyScopeOper:
          type:
          - string
          - 'null'
        ProductGroupScope:
          type:
          - array
          - 'null'
          items:
            type: string
        ProductGroupScopeOper:
          type:
          - string
          - 'null'
        ProductScope:
          type:
          - array
          - 'null'
          items:
            type: string
        ProductScopeOper:
          type:
          - string
          - 'null'
        RecurrenceFrequency:
          type:
          - string
          - 'null'
        RegionScope:
          type:
          - array
          - 'null'
          items:
            type: string
        RegionScopeOper:
          type:
          - string
          - 'null'
        RenewalEffectiveDate:
          type:
          - string
          - 'null'
          format: date-time
        SearchField:
          type:
          - string
          - 'null'
        Sequence:
          type:
          - number
          - 'null'
          format: double
        EnableCurrency:
          type:
          - boolean
          - 'null'
        Currency:
          type:
          - string
          - 'null'
        Status:
          type:
          - string
          - 'null'
        StopProcessingMoreIncentives:
          type:
          - boolean
          - 'null'
        SubUseType:
          type:
          - string
          - 'null'
        Upgrade:
          type:
          - string
          - 'null'
        UseType:
          type:
          - string
          - 'null'
        VersionNumber:
          type:
          - number
          - 'null'
          format: double
        Criteria:
          type:
          - string
          - 'null'
        ExclusionCriteria:
          type:
          - string
          - 'null'
        AdhocGroupScope:
          type:
          - array
          - 'null'
          items:
            type: string
        IncentiveConditionExpression:
          type:
          - string
          - 'null'
      additionalProperties: {}
      example:
        Name: PriceProgramName
        AccountScope:
        - All
        AccountScopeOper: in
        AccountTypeScope:
        - All
        AccountTypeScopeOper: in
        IsActive: true
        AmendmentEffectiveDate: null
        Ancestor: null
        ApplicationMethod: Buy X Get X
        AutoApply: true
        BenefitUom: null
        CombineWithOtherIncentives: false
        ContextType: Line Item
        CountryScope:
        - All
        CountryScopeOper: in
        CycleEndDate: null
        CycleStartDate: null
        Description: Price program description
        Downgrade: null
        EffectiveDate: '2022-10-10'
        EnableBenefitEffectivityDates: false
        ExcludeChildrenWithActivePrograms: false
        ExpirationDate: '2023-10-10'
        IncentiveCode: null
        IncentiveGroup: null
        IncentiveNumber: null
        IncentiveNumberAuto: null
        IncentiveNumberText: null
        IncludeOrdersForAccountHierarchy: false
        IsBundle: false
        Loyalty: null
        MaxPoints: null
        OriginalEffectiveDate: null
        PointAccrualLevel: null
        PriceListScope:
        - All
        PriceListScopeOper: in
        ProductFamilyScope:
        - All
        ProductFamilyScopeOper: in
        ProductGroupScope:
        - All
        ProductGroupScopeOper: in
        ProductScope:
        - All
        ProductScopeOper: in
        RecurrenceFrequency: null
        RegionScope:
        - All
        RegionScopeOper: in
        RenewalEffectiveDate: null
        SearchField: null
        Sequence: 1
        Status: New
        StopProcessingMoreIncentives: false
        SubUseType: Point Accrual
        Upgrade: null
        UseType: Price Program
        VersionNumber: null
        Criteria: null
        ExclusionCriteria: null
    LookupObject:
      type: object
      properties:
        Id:
          type:
          - string
          - 'null'
        Name:
          type:
          - string
          - 'null'
      additionalProperties: false
  securitySchemes:
    Bearer:
      type: apiKey
      description: Please insert JWT with Bearer into field
      name: Authorization
      in: header