> ## 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 una campaña

> Crea una nueva campaña de comunicaciones para la recuperación de pagos rechazados, con estado INACTIVE de forma predeterminada.

Crea una nueva campaña. Si no se proporciona `status`, las campañas quedan en `INACTIVE` de forma predeterminada.

Consulta la [referencia del objeto campaña](https://docs.y.uno/es/reference/communications-campaigns.md#campaign-object) para obtener más información.


## OpenAPI

````yaml openapi/es/communications-campaigns/create-campaign.json POST /campaigns
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:
    post:
      operationId: post_campaigns
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  description: Nombre de la campaña para identificarla.
                account_id:
                  type: string
                  description: >-
                    Tu ID de cuenta de Yuno, que se encuentra en el [Dashboard
                    de Yuno](https://dashboard.y.uno/developers) (UUID).
                organization_code:
                  type: string
                  description: El identificador de tu organización (UUID).
                country:
                  type: string
                  description: >-
                    Código de país ISO 3166-1 alpha-2 (p. ej., `CO`, `MX`,
                    `BR`).
                channel:
                  type: string
                  description: Canal de comunicación.
                  enum:
                    - WHATSAPP_MESSAGE
                    - PHONE_CALL
                focus:
                  type: string
                  description: >-
                    Descriptor del enfoque de la campaña (p. ej.,
                    `payment_recovery`).
                schedule:
                  type: object
                  properties:
                    daily_start_time:
                      type: string
                      description: Inicio de la ventana diaria de envío en formato `HH:MM`.
                    daily_end_time:
                      type: string
                      description: Fin de la ventana diaria de envío en formato `HH:MM`.
                    time_zone:
                      type: string
                      description: >-
                        Zona horaria IANA (p. ej., `America/Bogota`) o desfase
                        UTC (p. ej., `-05:00`)
                  required:
                    - daily_start_time
                    - daily_end_time
                    - time_zone
                  description: Configuración de programación.
                duration:
                  type: object
                  properties:
                    start_at:
                      type: string
                      description: Fecha de inicio de la campaña en formato ISO 8601.
                    end_at:
                      type: string
                      description: >-
                        Fecha de fin de la campaña en formato ISO 8601. Debe ser
                        posterior a `start_at`.
                  required:
                    - end_at
                    - start_at
                  description: Período activo de la campaña.
              required:
                - name
                - duration
                - schedule
                - channel
                - country
                - organization_code
                - account_id
            examples:
              Basic declined payment recovery:
                summary: Basic declined payment recovery
                value:
                  name: Mexico Card Recovery
                  account_id: YOUR_ACCOUNT_ID
                  organization_code: YOUR_ORGANIZATION_CODE
                  country: MX
                  channel: WHATSAPP_MESSAGE
                  focus: payment_recovery
                  schedule:
                    daily_start_time: '09:00'
                    daily_end_time: '20:00'
                    time_zone: America/Mexico_City
                  duration:
                    start_at: '2025-08-01T00:00:00Z'
                    end_at: '2026-08-01T00:00:00Z'
              High-value transaction recovery via phone call:
                summary: High-value transaction recovery via phone call
                value:
                  name: High Value Recovery - Phone
                  account_id: YOUR_ACCOUNT_ID
                  organization_code: YOUR_ORGANIZATION_CODE
                  country: CO
                  channel: PHONE_CALL
                  focus: payment_recovery
                  schedule:
                    daily_start_time: '09:00'
                    daily_end_time: '18:00'
                    time_zone: America/Bogota
                  duration:
                    start_at: '2025-08-01T00:00:00Z'
                    end_at: '2026-08-01T00:00:00Z'
      responses:
        '200':
          description: ''
        '201':
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                        example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                      name:
                        type: string
                        example: Declined Payment Recovery - Colombia
                      account_id:
                        type: string
                        example: 2404911d-5df9-429e-8488-ad41abea1a4b
                      organization_code:
                        type: string
                        example: 550e8400-e29b-41d4-a716-446655440000
                      country:
                        type: string
                        example: CO
                      channel:
                        type: string
                        example: WHATSAPP_MESSAGE
                      schedule:
                        type: object
                        properties:
                          daily_start_time:
                            type: string
                            example: '08:00'
                          daily_end_time:
                            type: string
                            example: '21:00'
                          time_zone:
                            type: string
                            example: America/Bogota
                      duration:
                        type: object
                        properties:
                          start_at:
                            type: string
                            example: '2025-07-01T00:00:00Z'
                          end_at:
                            type: string
                            example: '2026-07-01T00:00:00Z'
                      status:
                        type: string
                        example: ACTIVE
                      created_at:
                        type: string
                        example: '2025-07-01T12:00:00Z'
                      updated_at:
                        type: string
                        example: '2025-07-01T12:00:00Z'
              examples:
                Created:
                  summary: Created
                  value:
                    data:
                      id: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                      name: Declined Payment Recovery - Colombia
                      account_id: 2404911d-5df9-429e-8488-ad41abea1a4b
                      organization_code: 550e8400-e29b-41d4-a716-446655440000
                      country: CO
                      channel: WHATSAPP_MESSAGE
                      schedule:
                        daily_start_time: '08:00'
                        daily_end_time: '21:00'
                        time_zone: America/Bogota
                      duration:
                        start_at: '2025-07-01T00:00:00Z'
                        end_at: '2026-07-01T00:00:00Z'
                      status: ACTIVE
                      created_at: '2025-07-01T12:00:00Z'
                      updated_at: '2025-07-01T12:00:00Z'
          description: Creado
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.