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

# Create Custom Cap

Create a new custom cap setting. Custom caps allow you to override the default offer caps (conversions, payouts, clicks, and revenue) for a specific affiliate.


## OpenAPI

````yaml openapi/custom-caps.yaml post /networks/custom/caps
openapi: 3.0.3
info:
  title: Everflow Network API - Custom Caps
  description: >
    Endpoints for managing custom cap settings in the Everflow network. Custom
    caps let you set conversion, click, or impression limits at the partner or
    offer level — if both an offer and a partner have caps, Everflow stops
    conversions once either limit is reached. For setup, see the [Caps
    Management guide](https://helpdesk.everflow.io/customer/how-to-manage-caps).
  version: 1.0.0
servers:
  - url: https://api.eflow.team/v1
security: []
tags:
  - name: Custom Caps
paths:
  /networks/custom/caps:
    post:
      tags:
        - Custom Caps
      summary: Create Custom Cap
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CustomCapInput'
            example:
              network_affiliate_id: 28
              network_offer_id: 33
              is_soft_cap: false
              monthly_click_cap: 23
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CustomCap'
      security:
        - API Key: []
components:
  schemas:
    CustomCapInput:
      type: object
      required:
        - network_affiliate_id
        - network_offer_id
      properties:
        network_affiliate_id:
          type: integer
          description: The affiliate ID.
        network_offer_id:
          type: integer
          description: The offer ID.
        name:
          type: string
          description: The custom cap setting name.
        daily_conversion_cap:
          type: integer
          description: The daily conversion cap (0 for unlimited).
        weekly_conversion_cap:
          type: integer
          description: The weekly conversion cap (0 for unlimited).
        monthly_conversion_cap:
          type: integer
          description: The monthly conversion cap (0 for unlimited).
        global_conversion_cap:
          type: integer
          description: The global conversion cap (0 for unlimited).
        daily_payout_cap:
          type: number
          format: double
          description: The daily payout cap (0 for unlimited).
        weekly_payout_cap:
          type: number
          format: double
          description: The weekly payout cap (0 for unlimited).
        monthly_payout_cap:
          type: number
          format: double
          description: The monthly payout cap (0 for unlimited).
        global_payout_cap:
          type: number
          format: double
          description: The global payout cap (0 for unlimited).
        daily_click_cap:
          type: integer
          description: The daily click cap (0 for unlimited).
        weekly_click_cap:
          type: integer
          description: The weekly click cap (0 for unlimited).
        monthly_click_cap:
          type: integer
          description: The monthly click cap (0 for unlimited).
        global_click_cap:
          type: integer
          description: The global click cap (0 for unlimited).
        daily_revenue_cap:
          type: number
          format: double
          description: The daily revenue cap (0 for unlimited).
        weekly_revenue_cap:
          type: number
          format: double
          description: The weekly revenue cap (0 for unlimited).
        monthly_revenue_cap:
          type: number
          format: double
          description: The monthly revenue cap (0 for unlimited).
        global_revenue_cap:
          type: number
          format: double
          description: The global revenue cap (0 for unlimited).
        is_soft_cap:
          type: boolean
          description: >
            Whether this is a soft cap. Hard caps (false) stop conversions once
            the limit is reached. Soft caps (true) allow conversions beyond the
            limit.
    CustomCap:
      type: object
      properties:
        network_custom_cap_setting_id:
          type: integer
          example: 1
          description: Unique custom cap setting ID.
        network_id:
          type: integer
          example: 1
          description: Network ID.
        network_affiliate_id:
          type: integer
          example: 28
          description: The affiliate ID.
        network_offer_id:
          type: integer
          example: 33
          description: The offer ID.
        name:
          type: string
          description: The custom cap setting name.
        daily_conversion_cap:
          type: integer
          description: The daily conversion cap (0 for unlimited).
        weekly_conversion_cap:
          type: integer
          description: The weekly conversion cap (0 for unlimited).
        monthly_conversion_cap:
          type: integer
          description: The monthly conversion cap (0 for unlimited).
        global_conversion_cap:
          type: integer
          description: The global conversion cap (0 for unlimited).
        daily_payout_cap:
          type: number
          format: double
          description: The daily payout cap (0 for unlimited).
        weekly_payout_cap:
          type: number
          format: double
          description: The weekly payout cap (0 for unlimited).
        monthly_payout_cap:
          type: number
          format: double
          description: The monthly payout cap (0 for unlimited).
        global_payout_cap:
          type: number
          format: double
          description: The global payout cap (0 for unlimited).
        daily_click_cap:
          type: integer
          description: The daily click cap (0 for unlimited).
        weekly_click_cap:
          type: integer
          description: The weekly click cap (0 for unlimited).
        monthly_click_cap:
          type: integer
          description: The monthly click cap (0 for unlimited).
        global_click_cap:
          type: integer
          description: The global click cap (0 for unlimited).
        daily_revenue_cap:
          type: number
          format: double
          description: The daily revenue cap (0 for unlimited).
        weekly_revenue_cap:
          type: number
          format: double
          description: The weekly revenue cap (0 for unlimited).
        monthly_revenue_cap:
          type: number
          format: double
          description: The monthly revenue cap (0 for unlimited).
        global_revenue_cap:
          type: number
          format: double
          description: The global revenue cap (0 for unlimited).
        time_created:
          type: integer
          example: 1734455015
          description: Unix timestamp of creation.
        time_saved:
          type: integer
          example: 1734455015
          description: Unix timestamp of last update.
        is_soft_cap:
          type: boolean
          description: >-
            Whether this is a soft cap (allows conversions beyond the cap
            limit).
        relationship:
          type: object
          properties:
            affiliate:
              type: object
              description: Associated affiliate details.
              properties:
                network_affiliate_id:
                  type: integer
                  description: Unique affiliate ID.
                network_id:
                  type: integer
                  description: Network ID.
                name:
                  type: string
                  description: Affiliate name.
                account_status:
                  type: string
                  description: Account status of the affiliate.
            offer:
              type: object
              description: Associated offer details.
              properties:
                network_offer_id:
                  type: integer
                  description: Unique offer ID.
                network_id:
                  type: integer
                  description: Network ID.
                network_advertiser_id:
                  type: integer
                  description: Advertiser ID that owns this offer.
                network_offer_group_id:
                  type: integer
                  description: Offer group ID (0 if not grouped).
                name:
                  type: string
                  description: Offer name.
                offer_status:
                  type: string
                  description: Status of the offer.
                network_tracking_domain_id:
                  type: integer
                  description: Tracking domain ID for this offer.
                visibility:
                  type: string
                  description: Visibility setting for this offer.
                currency_id:
                  type: string
                  description: Currency code for this offer.
  securitySchemes:
    API Key:
      description: The Everflow API key generated from the Control Center > Security.
      in: header
      name: X-Eflow-Api-Key
      type: apiKey

````