Impact

Impact Promo Code Exception Lists API

The Promo Code Exception Lists API from Impact — 4 operation(s) for promo code exception lists.

GitHub OpenAPI

Operations 5

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

POST /Advertisers/{AccountSID}/PromoCodeExceptionLists Create a promo code exception list · Create a Promo Code Exception List #
Ask an LLM
“How do I set up a list of promo codes that pay a different commission rate?”
“What do I need to create an empty promo code exception list?”
Tell an agent
Create promo code exception list {name} for program {campaign} and tracker {tracker} in account {account}.
Start a new empty promo code list called {name} on tracker {tracker}, program {campaign}, account {account}.
GET /Advertisers/{AccountSID}/PromoCodeExceptionLists/{ListId} Get a brand's promo code exception list · Get Promo Code Exception List Details #
Ask an LLM
“As a brand, what's configured on one of my promo code exception lists?”
“Can a brand fetch a promo code exception list by its ID?”
Tell an agent
As brand account {account}, get promo code exception list {list}.
Show brand promo code list {list} in account {account}.
PUT /Advertisers/{AccountSID}/PromoCodeExceptionLists/{ListId} Rename or retarget a promo code exception list · Update a Promo Code Exception List #
Ask an LLM
“Can I rename a promo code exception list or change its action trackers?”
“Which fields of a promo code exception list are editable?”
Tell an agent
Rename promo code exception list {list} to {name} in account {account}.
Point promo code exception list {list} at tracker {tracker} in account {account}.
GET /Mediapartners/{AccountSID}/PromoCodeExceptionLists/{PromoCodeExceptionListId} Retrieve a partner's promo code exception list · Retrieve a Promo Code Exception List #
Ask an LLM
“As a partner, can I view a promo code exception list referenced in my contract?”
“Where does a partner find a promo code exception list's details?”
Tell an agent
As partner account {account}, retrieve promo code exception list {list}.
Get partner-side promo code list {list} for account {account}.
GET /Mediapartners/{AccountSID}/PromoCodeExceptionLists/{PromoCodeExceptionListId}/Items List codes in a promo code exception list · List Promo Code Exception List Items #
Ask an LLM
“Which promo codes trigger an alternate commission rate for me as a partner?”
“Can a partner see every code value inside a promo code exception list?”
Tell an agent
As partner account {account}, list the codes in promo code exception list {list}.
Show every promo code value on list {list} in account {account}.

Documentation

📖
Documentation
https://integrations.impact.com/brand-api-reference
📖
APIReference
https://integrations.impact.com/brand-api-reference/readme
📖
Authentication
https://integrations.impact.com/brand-api-reference/readme/authentication
📖
RateLimits
https://integrations.impact.com/brand-api-reference/readme/rate-limits
📖
Documentation
https://integrations.impact.com/partner-api-reference
📖
APIReference
https://integrations.impact.com/partner-api-reference/readme
📖
Documentation
https://integrations.impact.com/agency-v3
📖
APIReference
https://integrations.impact.com/agency-v3/readme
📖
Authentication
https://integrations.impact.com/agency-v3/readme/authentication
📖
Documentation
https://integrations.impact.com/brand-api-reference/advocate-api-reference-v1
📖
Authentication
https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-api/advocate-rest-api

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/impact/refs/heads/main/openapi/impact-promo-code-exception-lists-api-openapi.yml

Other Resources

🔗
ChangeLog
https://integrations.impact.com/brand-api-reference/readme/changelog
🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/impact/refs/heads/main/asyncapi/impact-webhooks.yml
🔗
Webhooks
https://integrations.impact.com/partner-api-reference/reference/webhooks/event-notifications
🔗
ChangeLog
https://integrations.impact.com/agency-v3/readme/changelog
🔗
GraphQL
https://raw.githubusercontent.com/api-evangelist/impact/refs/heads/main/graphql/impact-advocate-graphql.yml
🔗
Webhooks
https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-api/api-webhooks-for-advocate-programs

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/impact:impact-promo-code-exception-lists-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

impact-promo-code-exception-lists-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Impact Promo Code Exception Lists API
  version: '1.0'
  description: 'Operations tagged Promo Code Exception Lists across 2 of this provider''s published API definitions: impact-brand-promocodeexceptionlists-v14-openapi.yml, impact-partner-promocodeexceptionlists-v16-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.impact.com
tags:
- name: Promo Code Exception Lists
paths:
  /Advertisers/{AccountSID}/PromoCodeExceptionLists:
    post:
      summary: Create a Promo Code Exception List
      description: Creates a new, empty list for promo codes that will have exceptional payout rates.
      operationId: createPromoCodeExceptionList
      tags:
      - Promo Code Exception Lists
      parameters:
      - name: AccountSID
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
              - ActionTrackerId
              - CampaignId
              - Name
              properties:
                ActionTrackerId:
                  type: string
                  description: Comma-separated list of event type IDs to associate with this list.
                  example: '18500'
                CampaignId:
                  type: string
                  description: The program ID this list applies to.
                  example: '1000'
                Name:
                  type: string
                  description: The name for the new exception list.
                  example: Excluded-Influencer-Codes
      responses:
        '200':
          $ref: '#/components/responses/SuccessUriResponse'
      x-codeSamples:
      - lang: cURL
        source: "curl -L \\\n  --request POST \\\n  --url 'https://api.impact.com/Advertisers/{AccountSID}/PromoCodeExceptionLists' \\\n  --user '{AccountSID}:{AuthToken}' \\\n  --header 'Content-Type: application/x-www-form-urlencoded' \\\n  --header 'Accept: */*'"
      security:
      - basicAuth: []
    servers:
    - url: https://api.impact.com
  /Advertisers/{AccountSID}/PromoCodeExceptionLists/{ListId}:
    get:
      summary: Get Promo Code Exception List Details
      description: Retrieves the details of an existing promo code exception list by its unique ID.
      operationId: getPromoCodeExceptionListById
      tags:
      - Promo Code Exception Lists
      parameters:
      - name: AccountSID
        in: path
        required: true
        schema:
          type: string
      - name: ListId
        in: path
        required: true
        description: The unique identifier for the promo code exception list.
        schema:
          type: string
      responses:
        '200':
          description: A single promo code exception list object.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PromoCodeExceptionList'
      x-codeSamples:
      - lang: cURL
        source: "curl -L \\\n  --url 'https://api.impact.com/Advertisers/{AccountSID}/PromoCodeExceptionLists/{ListId}' \\\n  --user '{AccountSID}:{AuthToken}' \\\n  --header 'Accept: */*'"
      security:
      - basicAuth: []
    put:
      summary: Update a Promo Code Exception List
      description: Updates the specified promo code exception list's name or associated action trackers.
      operationId: updatePromoCodeExceptionList
      tags:
      - Promo Code Exception Lists
      parameters:
      - name: AccountSID
        in: path
        required: true
        schema:
          type: string
      - name: ListId
        in: path
        required: true
        description: The unique identifier for the promo code exception list.
        schema:
          type: string
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                ActionTrackerId:
                  type: string
                  description: A new comma-separated list of event type IDs.
                  example: '18500'
                Name:
                  type: string
                  description: A new name for the exception list.
                  example: Excluded-Influencer-Codes
      responses:
        '200':
          $ref: '#/components/responses/SuccessUriResponse'
      x-codeSamples:
      - lang: cURL
        source: "curl -L \\\n  --request PUT \\\n  --url 'https://api.impact.com/Advertisers/{AccountSID}/PromoCodeExceptionLists/{ListId}' \\\n  --user '{AccountSID}:{AuthToken}' \\\n  --header 'Content-Type: application/x-www-form-urlencoded' \\\n  --header 'Accept: */*'"
      security:
      - basicAuth: []
    servers:
    - url: https://api.impact.com
  /Mediapartners/{AccountSID}/PromoCodeExceptionLists/{PromoCodeExceptionListId}:
    get:
      operationId: retrievePromoCodeExceptionList
      tags:
      - Promo Code Exception Lists
      summary: Retrieve a Promo Code Exception List
      description: Retrieves the details of an existing promo code exception list using its unique ID. The PromoCodeExceptionListId can be obtained from the Contracts API.
      parameters:
      - name: AccountSID
        in: path
        required: true
        schema:
          type: string
        description: Unique identifier for the partner account.
      - name: PromoCodeExceptionListId
        in: path
        required: true
        schema:
          type: string
        description: The unique identifier for the promo code exception list.
      responses:
        '200':
          description: The promo code exception list object.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PromoCodeExceptionList_2'
    servers:
    - url: https://api.impact.com
  /Mediapartners/{AccountSID}/PromoCodeExceptionLists/{PromoCodeExceptionListId}/Items:
    get:
      operationId: listPromoCodeExceptionListItems
      tags:
      - Promo Code Exception Lists
      summary: List Promo Code Exception List Items
      description: Returns a list of all items in a specific promo code exception list. Each item defines a promo code value that triggers an alternate commission rate.
      parameters:
      - name: AccountSID
        in: path
        required: true
        schema:
          type: string
        description: Unique identifier for the partner account.
      - name: PromoCodeExceptionListId
        in: path
        required: true
        schema:
          type: string
        description: The unique identifier for the promo code exception list whose items are being retrieved.
      responses:
        '200':
          description: A list of promo code exception list item objects.
          content:
            application/json:
              schema:
                type: object
                properties:
                  PromoCodeExceptionListItems:
                    type: array
                    items:
                      $ref: '#/components/schemas/PromoCodeExceptionListItem'
    servers:
    - url: https://api.impact.com
components:
  schemas:
    PromoCodeExceptionList:
      type: object
      properties:
        Id:
          type: string
          description: The unique identifier for the promo code exception list.
          example: '99999'
        Name:
          type: string
          description: The display name for the exception list.
          example: Excluded-Influencer-Codes
        State:
          type: string
          description: The current state of the exception list.
          enum:
          - ACTIVE
          - CLOSED
          - DEACTIVATED
        CampaignId:
          type: string
          description: The program ID the list applies to.
          example: '1000'
        CreatedDate:
          type: string
          format: date-time
          description: The date and time the list was created.
          example: '2026-01-15T10:00:00-08:00'
        DeactivationDate:
          type: string
          format: date-time
          nullable: true
          description: The date and time the list was deactivated, if applicable.
          example: '2026-12-31T23:59:59-08:00'
        ActionTrackers:
          type: array
          description: The action trackers (event types) this list applies to.
          items:
            type: object
            properties:
              Id:
                type: string
                description: The unique identifier for the action tracker.
                example: '18500'
              Name:
                type: string
                description: The display name of the action tracker.
                example: Online Sale
        NumberOfItems:
          type: string
          description: The total number of items in the list.
          example: '50'
        ItemsUri:
          type: string
          format: uri-reference
          description: The unique reference to the items collection for this list.
          example: /Advertisers/<AccountSID>/PromoCodeExceptionLists/99999/Items
        Uri:
          type: string
          format: uri-reference
          description: The unique reference to this exception list in the impact.com API.
          example: /Advertisers/{AccountSID}/PromoCodeExceptionLists/12345
    PromoCodeExceptionListItem:
      type: object
      description: An item within a promo code exception list that defines a specific promo code value triggering an alternate commission rate.
      properties:
        Id:
          type: string
          description: Unique identifier for the promo code exception list item.
          example: '1'
        ListId:
          type: string
          description: Unique identifier for the parent promo code exception list.
          example: '6001'
        Name:
          type: string
          description: Display name of the promo code exception list item.
          example: Summer Sale Code
        Value:
          type: string
          description: The promo code value this item matches against.
          example: SUMMER2026
        MatchMode:
          type: string
          enum:
          - EQ
          - REGEX
          description: The matching methodology used to evaluate the promo code value. EQ matches exactly; REGEX matches using a regular expression.
          example: EQ
        CreatedDate:
          type: string
          format: date-time
          description: Date and time this item was added to the promo code exception list (ISO 8601).
          example: '2024-03-10T09:00:00-08:00'
        Uri:
          type: string
          description: Unique reference to the promo code exception list item in the impact.com API.
          example: /Mediapartners/<AccountSID>/PromoCodeExceptionLists/6001/Items/1
    PromoCodeExceptionList_2:
      type: object
      properties:
        Id:
          type: string
          description: Unique identifier for the promo code exception list.
          example: '6001'
        Name:
          type: string
          description: Display name of the promo code exception list.
          example: VIP Partner Promo Exclusions
        State:
          type: string
          enum:
          - ACTIVE
          - CLOSED
          - DEACTIVATED
          description: The current state of the promo code exception list.
          example: ACTIVE
        CampaignId:
          type: string
          description: Unique identifier for the program this promo code exception list applies to.
          example: '10306'
        CreatedDate:
          type: string
          format: date-time
          description: Date and time the promo code exception list was created (ISO 8601).
          example: '2024-03-10T09:00:00-08:00'
        DeactivationDate:
          type: string
          format: date-time
          description: Date and time the promo code exception list was deactivated (ISO 8601). Empty if the list is still active.
          example: ''
        NumberOfItems:
          type: string
          description: The number of items in the promo code exception list.
          example: '5'
        ItemsUri:
          type: string
          description: API resource path for retrieving the items in this promo code exception list.
          example: /Mediapartners/<AccountSID>/PromoCodeExceptionLists/6001/Items
        Uri:
          type: string
          description: Unique reference to the promo code exception list object in the impact.com API.
          example: /Mediapartners/<AccountSID>/PromoCodeExceptionLists/6001
  responses:
    SuccessUriResponse:
      description: The request was successful.
      content:
        application/json:
          schema:
            type: object
            properties:
              Status:
                type: string
                description: Indicates whether the operation was successful.
                example: OK
              Uri:
                type: string
                format: uri-reference
                description: The unique reference to the affected resource.
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: Use your AccountSID as the username and AuthToken as the password.
x-refined-from:
- impact-brand-promocodeexceptionlists-v14-openapi.yml
- impact-partner-promocodeexceptionlists-v16-openapi.yml