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

# Update notification preferences

> Set notification opt-in preferences for the authenticated user. Replaces all existing opt-ins.



## OpenAPI

````yaml /v2/storefront-api-v2.yaml put /notification-preferences
openapi: 3.0.0
info:
  title: Scope3 Storefront API
  version: 2.0.0
  description: |-
    REST API for partners to manage storefronts, inventory sources, and billing.

    ## Authentication

    All endpoints require a Bearer token in the Authorization header:
    ```
    Authorization: Bearer your-api-key
    ```

    ## Base URL

    `https://api.interchange.io/api/v2/storefront`

    ## For AI Agents

    AI agents can use the MCP endpoint at `/mcp/v2/storefront` with three tools:
    - `initialize`: Start an MCP session
    - `api_call`: Make REST API calls
    - `ask_about_capability`: Learn about API features
servers:
  - url: https://api.interchange.io/api/v2/storefront
    description: Production server
security: []
tags:
  - name: Account
    description: Account management, service tokens, and preferences
  - name: Asks
    description: >-
      What you are waiting on Scope3 for — support, product, and supply asks in
      one list
  - name: Storefront
    description: Manage storefront and inventory sources
  - name: Storefront Agents
    description: List and manage registered sales, signals, and outcomes agents
  - name: Storefront Activity
    description: Audit log of configuration and inventory changes on the storefront
  - name: Storefront Billing
    description: Payout bank details and billing configuration for storefronts
  - name: AI Usage
    description: Storefront AI token usage visibility by model
  - name: MCP
    description: Model Context Protocol endpoints
paths:
  /notification-preferences:
    servers:
      - url: https://api.interchange.io/api/v2
        description: Production server
    put:
      tags:
        - Account
      summary: Update notification preferences
      description: >-
        Set notification opt-in preferences for the authenticated user. Replaces
        all existing opt-ins.
      operationId: updateNotificationPreferences
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                optIns:
                  maxItems: 200
                  type: array
                  items:
                    type: object
                    properties:
                      notificationType:
                        description: >-
                          Notification event type to opt into. The enum is
                          shared across personas, but each event type delivers
                          only to the customer role it is scoped to —
                          storefront.* and inventory_source.* deliver to SELLER
                          customers; campaign.*, creative approval outcomes, and
                          media_buy_update_proposal.* deliver to BUYER
                          customers. Opting into an event type outside your role
                          delivers nothing.
                        type: string
                        enum:
                          - brand_agent.created
                          - brand_agent.updated
                          - brand_agent.deleted
                          - campaign.healthy
                          - campaign.unhealthy
                          - campaign.created
                          - campaign.updated
                          - campaign.deleted
                          - campaign.completed
                          - creative.approved
                          - creative.rejected
                          - creative.changes_requested
                          - creative.sync_started
                          - creative.sync_completed
                          - creative.sync_failed
                          - creative.created
                          - creative.updated
                          - creative.deleted
                          - strategy.created
                          - strategy.updated
                          - strategy.deleted
                          - media_buy.created
                          - media_buy.updated
                          - media_buy.deleted
                          - media_buy_update_proposal.approved
                          - media_buy_update_proposal.rejected
                          - media_buy_update_proposal.expired
                          - salesagent.available
                          - salesagent.unavailable
                          - salesagent.registered
                          - salesagent.unregistered
                          - salesagent.updated
                          - salesagent.sync_action_required
                          - signalsagent.registered
                          - signalsagent.unregistered
                          - signalsagent.updated
                          - signalsagent.signal_activated
                          - signalsagent.signals_fetched
                          - outcomesagent.registered
                          - outcomesagent.unregistered
                          - outcomesagent.updated
                          - syndication.completed
                          - syndication.failed
                          - audience.synced
                          - audience.sync_failed
                          - optimization.suggestion_received
                          - optimization.suggestion_approved
                          - optimization.suggestion_rejected
                          - optimization.suggestion_applied
                          - optimization.suggestion_failed
                          - system.warning
                          - system.error
                          - learning_cycle.completed
                          - learning_cycle.failed
                          - hypothesis.status_changed
                          - hypothesis.review_requested
                          - hypothesis.proven
                          - hypothesis.disproven
                          - measurement.received
                          - measurement.stale
                          - opportunity.evaluated
                          - opportunity.recommended
                          - opportunity.flagged
                          - opportunity.explore
                          - storefront.composition_paused
                          - storefront.products_not_traffickable
                          - storefront_adapter_credential.action_required
                          - storefront_adapter_connection.mapping_required
                          - inventory_source.unhealthy
                          - inventory_source.recovered
                          - source.action_required
                          - source.action_resolved
                          - storefront.supply_nudge
                          - storefront.liveness_degraded
                          - storefront.liveness_recovered
                          - provider_fleet.incident_opened
                          - provider_fleet.incident_recovered
                          - media_buy.approval_requested
                          - creative.review_requested
                          - ad_server.approval_requested
                          - inventory_shortfall.review_requested
                          - storefront.media_buy_forward_failed
                          - storefront.media_buy_moderation_aging
                          - murph_room.mentioned
                          - ask.resolved
                      channel:
                        type: string
                        enum:
                          - email
                          - in_app
                    required:
                      - notificationType
                      - channel
              required:
                - optIns
      responses:
        '200':
          description: Update notification preferences
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - bearerAuth: []
components:
  schemas:
    ErrorResponse:
      description: Standard error response
      type: object
      properties:
        data:
          type: string
          nullable: true
          enum:
            - null
        error:
          $ref: '#/components/schemas/ApiError'
      required:
        - data
        - error
      additionalProperties: false
    ApiError:
      description: Structured error object
      type: object
      properties:
        code:
          description: Machine-readable error code
          type: string
        message:
          description: Human-readable error message
          type: string
        field:
          description: Field path associated with the error
          type: string
        details:
          description: Additional error context
          type: object
          additionalProperties: {}
      required:
        - code
        - message
      additionalProperties: false
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key or access token

````