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

> ## Agent Instructions
> Test in the sandbox first: base URL https://api-sandbox.y.uno (Test Mode in the Dashboard). Production is https://api.y.uno (Live Mode).
> Every API request needs the public-api-key and private-secret-key headers. Get them in the Dashboard at https://dashboard.y.uno/developers (Developers > Credentials); sandbox and production keys are different.
> Send an X-Idempotency-Key (a UUID) when creating payments, refunds and cancels, so retries do not create duplicates.
> Start with the Quickstart (https://docs.y.uno/docs/quickstart.md) and the agent guide (https://docs.y.uno/agents.md). To search these docs from a coding agent, connect the docs MCP server at https://docs.y.uno/mcp.

# Crear reglas

> Crea una o más reglas de segmentación que determinan qué pagos rechazados activan una campaña.

Crea una o más reglas para una campaña. Todas las reglas activas deben cumplirse para que un pago active la campaña (lógica AND).

Visita la [referencia de operadores condicionales](https://docs.y.uno/es/reference/communications-campaigns.md#conditional-operators-reference) para más información sobre cómo usarlos.


## OpenAPI

````yaml openapi/es/communications-campaigns/create-rules.json POST /campaigns/{campaign_id}/rules
openapi: 3.0.0
info:
  version: 1.0.0
  title: Communications Campaigns
servers:
  - url: https://api-sandbox.y.uno/v1
    description: Sandbox
  - url: https://api.y.uno/v1
    description: Production (US)
security:
  - public-api-key: []
    private-secret-key: []
paths:
  /campaigns/{campaign_id}/rules:
    post:
      operationId: post_campaigns-campaign-id-rules
      parameters:
        - in: path
          name: campaign_id
          schema:
            type: string
          required: true
          description: El identificador de la campaña (UUID).
      requestBody:
        content:
          application/json:
            schema:
              type: array
              description: >-
                Arreglo de objetos de regla. Envía el arreglo como cuerpo de la
                solicitud, sin un objeto envolvente.
              items:
                type: object
                properties:
                  rule_type:
                    type: string
                    description: >-
                      Tipo de regla (consulta [Rule Types
                      Reference](/es/reference/communications-campaigns#rule-types-reference))
                  values:
                    type: array
                    items:
                      type: string
                    description: >-
                      Arreglo de valores de cadena para la comparación. No es
                      obligatorio para `UNIQUE_BY_USER`.
                  conditional:
                    type: string
                    description: >-
                      Operador de comparación. No es obligatorio para
                      `USER_COMMS_PER_DAY` ni `UNIQUE_BY_USER`. Consulta
                      [Conditional Operators
                      Reference](/es/reference/communications-campaigns#conditional-operators-reference).
                  metadata_key:
                    type: string
                    description: >-
                      Obligatorio cuando `rule_type` es `METADATA`. El nombre
                      del campo de metadatos que se evaluará.
                required:
                  - rule_type
            examples:
              Basic declined payment recovery:
                summary: Basic declined payment recovery
                value:
                  - rule_type: PAYMENT_STATUS
                    values:
                      - DECLINED
                    conditional: EQUAL
                  - rule_type: PAYMENT_METHOD
                    values:
                      - CARD
                    conditional: EQUAL
              High-value transaction recovery via phone call:
                summary: High-value transaction recovery via phone call
                value:
                  - rule_type: PAYMENT_STATUS
                    values:
                      - DECLINED
                    conditional: EQUAL
                  - rule_type: AMOUNT_AND_CURRENCY
                    values:
                      - '500'
                      - USD
                    conditional: GREATER_THAN
                  - rule_type: USER_COMMS_PER_DAY
                    values:
                      - '1'
              Provider-specific recovery with amount range:
                summary: Provider-specific recovery with amount range
                value:
                  - rule_type: PAYMENT_STATUS
                    values:
                      - DECLINED
                    conditional: EQUAL
                  - rule_type: PROVIDER
                    values:
                      - stripe
                      - adyen
                    conditional: ONE_OF
                  - rule_type: AMOUNT
                    values:
                      - '10000'
                      - '500000'
                    conditional: BETWEEN
                  - rule_type: CURRENCY
                    values:
                      - COP
                    conditional: EQUAL
              Metadata-based segmentation:
                summary: Metadata-based segmentation
                value:
                  - rule_type: PAYMENT_STATUS
                    values:
                      - DECLINED
                    conditional: EQUAL
                  - rule_type: METADATA
                    metadata_key: vertical
                    values:
                      - restaurant
                      - grocery
                    conditional: ONE_OF
                  - rule_type: METADATA
                    metadata_key: customer_tier
                    values:
                      - premium
                      - gold
                    conditional: ONE_OF
                  - rule_type: UNIQUE_BY_USER
              Exclude specific response codes:
                summary: Exclude specific response codes
                value:
                  - rule_type: PAYMENT_STATUS
                    values:
                      - DECLINED
                    conditional: EQUAL
                  - rule_type: ISO_RESPONSE_CODE
                    values:
                      - '14'
                      - '43'
                      - '59'
                    conditional: NOT_ONE_OF
      responses:
        '201':
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          example: f1e2d3c4-b5a6-7890-abcd-ef1234567890
                        rule_type:
                          type: string
                          example: PAYMENT_STATUS
                        values:
                          type: array
                          items:
                            type: string
                          example:
                            - DECLINED
                        conditional:
                          type: string
                          example: EQUAL
                        metadata_key:
                          type: string
                          nullable: true
                          example: null
                        status:
                          type: string
                          example: ACTIVE
                        created_at:
                          type: string
                          example: '2025-07-01T12:05:00Z'
                        updated_at:
                          type: string
                          example: '2025-07-01T12:05:00Z'
              examples:
                Created:
                  summary: Created
                  value:
                    data:
                      - id: f1e2d3c4-b5a6-7890-abcd-ef1234567890
                        rule_type: PAYMENT_STATUS
                        values:
                          - DECLINED
                        conditional: EQUAL
                        metadata_key: null
                        status: ACTIVE
                        created_at: '2025-07-01T12:05:00Z'
                        updated_at: '2025-07-01T12:05:00Z'
                      - id: a9b8c7d6-e5f4-3210-abcd-ef1234567890
                        rule_type: CURRENCY
                        values:
                          - COP
                        conditional: EQUAL
                        metadata_key: null
                        status: ACTIVE
                        created_at: '2025-07-01T12:05:00Z'
                        updated_at: '2025-07-01T12:05:00Z'
                      - id: 11223344-5566-7788-99aa-bbccddeeff00
                        rule_type: AMOUNT
                        values:
                          - '50000'
                        conditional: GREATER_THAN
                        metadata_key: null
                        status: ACTIVE
                        created_at: '2025-07-01T12:05:00Z'
                        updated_at: '2025-07-01T12:05:00Z'
          description: Creado
        '404':
          description: No encontrado. La campaña no existe para esta cuenta.
          content:
            application/json:
              examples:
                Not Found:
                  value:
                    code: NOT_FOUND
                    messages:
                      - Not Found
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: NOT_FOUND
                  messages:
                    type: array
                    items:
                      type: string
                      example: Not Found
components:
  securitySchemes:
    public-api-key:
      type: apiKey
      in: header
      name: public-api-key
    private-secret-key:
      type: apiKey
      in: header
      name: private-secret-key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.