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

# Inscribir un contacto en la campaña

> Crea el contacto si aún no existe y lo inscribe en la campaña. Identifique por `contact.phone` (E.164) y/o `contact.linkedin_identifier` — al menos uno; una campaña de WhatsApp exige phone, una de LinkedIn exige linkedin. Solo campañas ACTIVE (409 en caso contrario). Una conversación activa o un canal incompatible devuelven `status: "skipped"`. `contact.external_id` sobrescribe el vínculo de CRM del contacto.



## OpenAPI

````yaml /es/openapi.json post /v1/campaigns/{campaignId}/enrollments/from-contact
openapi: 3.0.0
info:
  title: Nuvia API - Empresa
  description: Documentación de la API para empresas
  version: '1.0'
  contact: {}
servers:
  - url: https://api.nuvia.ai
security: []
tags:
  - name: messages
    x-group: Mensajes
  - name: contacts
    x-group: Contactos
  - name: campaigns
    x-group: Campañas
  - name: tables
    x-group: Tablas y listas
  - name: agents
    x-group: Agentes
  - name: conversations
    x-group: Conversaciones
  - name: inboxes
    x-group: Inboxes
  - name: knowledge
    x-group: Base de conocimiento
  - name: Webhooks
    x-group: Webhooks
  - name: campaign-enrollments
    x-group: Inscripciones en Campaña
  - name: custom-fields
    x-group: Campos personalizados
  - name: resources
    x-group: Archivos y adjuntos
  - name: hubspot
    x-group: HubSpot
  - name: users
    x-group: Usuarios
paths:
  /v1/campaigns/{campaignId}/enrollments/from-contact:
    post:
      tags:
        - campaign-enrollments
      summary: Inscribir un contacto en la campaña
      description: >-
        Crea el contacto si aún no existe y lo inscribe en la campaña.
        Identifique por `contact.phone` (E.164) y/o
        `contact.linkedin_identifier` — al menos uno; una campaña de WhatsApp
        exige phone, una de LinkedIn exige linkedin. Solo campañas ACTIVE (409
        en caso contrario). Una conversación activa o un canal incompatible
        devuelven `status: "skipped"`. `contact.external_id` sobrescribe el
        vínculo de CRM del contacto.
      operationId: EnrollmentFromContactController_fromContact
      parameters:
        - name: campaignId
          required: true
          in: path
          description: ID de la campaña (debe estar ACTIVE)
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EnrollFromContactBodyDto'
            examples:
              whatsapp:
                summary: Contato de campanha de WhatsApp
                value:
                  contact:
                    name: Maria Souza
                    phone: '+5511999998888'
                    email: maria.souza@exemplo.com.br
                    job_title: Gerente de Compras
                  fields:
                    origem: site
      responses:
        '201':
          description: ''
          content:
            application/json:
              schema:
                type: object
      security:
        - JWT-auth: []
components:
  schemas:
    EnrollFromContactBodyDto:
      type: object
      properties:
        contact:
          type: object
          properties:
            external_id:
              description: >-
                ID del contacto en el CRM de origen (texto o número). Si se
                envía, reemplaza el vínculo de CRM del contacto; si no se envía,
                se conserva el vínculo actual.
              anyOf:
                - type: string
                  minLength: 1
                - type: number
            name:
              description: >-
                Nombre del contacto. En un contacto existente, solo se actualiza
                con `overwrite_name` o `external_id`.
              type: string
              maxLength: 200
            email:
              description: Correo electrónico del contacto.
              type: string
              format: email
              pattern: >-
                ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
            phone:
              description: >-
                Teléfono en E.164 (ej.: +5511999999999). Identifica el contacto;
                obligatorio en campaña de WhatsApp.
              type: string
              pattern: ^\+[1-9]\d{7,14}$
            linkedin_identifier:
              description: >-
                Identificador del perfil de LinkedIn. Obligatorio en campaña de
                LinkedIn.
              type: string
              minLength: 1
              maxLength: 300
            company:
              description: Nombre de la empresa del contacto.
              type: string
              maxLength: 200
            job_title:
              description: >-
                Campo de perfil del contacto. Se guarda cuando se envía; si no
                se envía, se mantiene el valor actual.
              type: string
              maxLength: 500
            department:
              description: >-
                Campo de perfil del contacto. Se guarda cuando se envía; si no
                se envía, se mantiene el valor actual.
              type: string
              maxLength: 500
            seniority:
              description: >-
                Campo de perfil del contacto. Se guarda cuando se envía; si no
                se envía, se mantiene el valor actual.
              type: string
              maxLength: 500
            country:
              description: >-
                Campo de perfil del contacto. Se guarda cuando se envía; si no
                se envía, se mantiene el valor actual.
              type: string
              maxLength: 500
            region:
              description: >-
                Campo de perfil del contacto. Se guarda cuando se envía; si no
                se envía, se mantiene el valor actual.
              type: string
              maxLength: 500
            city:
              description: >-
                Campo de perfil del contacto. Se guarda cuando se envía; si no
                se envía, se mantiene el valor actual.
              type: string
              maxLength: 500
            experience:
              description: >-
                Campo de perfil del contacto. Se guarda cuando se envía; si no
                se envía, se mantiene el valor actual.
              type: string
              maxLength: 5000
          description: >-
            Contacto a inscribir. Informe `phone` y/o `linkedin_identifier`: al
            menos uno es obligatorio.
        fields:
          type: object
          description: >-
            Campos personalizados del contacto, por slug: `{ "slug": valor }`.
            Un slug sin custom field de contacto se ignora.
          additionalProperties: {}
        enroll_again:
          type: boolean
          description: >-
            Si es true y el contacto ya concluyó la campaña, reactiva la
            inscripción para un nuevo envío. No afecta una inscripción en curso.
        overwrite_name:
          type: boolean
          description: >-
            Si es true, `contact.name` reemplaza el nombre de un contacto que ya
            existe. Por defecto, el nombre solo se guarda en la creación.
      required:
        - contact
  securitySchemes:
    JWT-auth:
      scheme: bearer
      bearerFormat: JWT
      type: http
      description: Token JWT de autenticación

````

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