Create Appointment_External

Esta variante de la mutación de registro permite agendar y dar de alta una nueva cita en la plataforma vinculando la taxonomía del encuentro directamente a través de los identificadores e integraciones del sistema del cliente (companyExternalId y statuteExternalId), evitando depender de los IDs internos de la plataforma. Admite de manera nativa y opcional flujos avanzados con invitados o representación legal.

Detalles de la Solicitud

• Método HTTP: POST

• URL PRE: https://api.ovac.pre.councilbox.com/graphql

• URL PRO: https://api.ovac.councilbox.com/graphql

Autenticación

Tipo: API Key**
Header:** x-jwt-token
Ubicación: Header HTTP_
Ejemplo:_ x-jwt-token: eyJhbGciOiJIUzI1NiIsInR5cCI6...

Referencia de la API

Variables Globales de Entrada

Desglose del Objeto council (CouncilInput)

Desglose del Objeto participant (ParticipantInput)

Campos de Respuesta (Payload)

La respuesta exitosa devuelve el objeto createOneOnOneCouncil con las claves únicas de la cita generada:

Ejemplos de Código y Peticiones

1. Mutación GraphQL

mutation CreateOneOnOneCouncil(
    $council: CouncilInput,
    $participant: ParticipantInput,
    $representation: ParticipantInput,
    $notifyCreation: Boolean,
    $checkAgenda: Boolean,
    $guests: [ParticipantInput]
) {
    createOneOnOneCouncil(
        council: $council,
        participant: $participant,
        representation: $representation,
        notifyCreation: $notifyCreation,
        checkAgenda: $checkAgenda,
        guests: $guests
    ) {
        id
        accessLink
        creatorId
    }
}

2. Variables de la Petición (JSON Payload con Mapeos Externos)

{
    "council": {
        "name": "test creación cita",
        "companyExternalId": "EXT_COMP_2191",
        "statuteExternalId": "EXT_STAT_4685",
        "councilType": 5,
        "externalId": "SISTEMA_EXTERNO_001",
        "contactEmail": "soporte@entidad.com",
        "dateStart": "2026-05-16T15:00:00Z",
        "conveneText": "",
        "observations": "Estas son observaciones",
        "internalNotes": "Estas son notas internas",
        "language": "gal",
        "comment": "Opcional - Información visible mail de creación de cita",
        "readOnly": 0,
        "tag": "ADMIN"
    },
    "participant": {
        "name": "Name of participant",
        "surname": "Surname of participant",
        "idCardType": "dni",
        "dni": "11111111H",
        "idCardCountry": "ES",
        "email": "participant_email@domain.com",
        "phone": "+34600000000",
        "language": "gal",
        "zipcode": "00000"
    },
    "notifyCreation": true,
    "checkAgenda": true
}

3. Ejemplo de comando cURL

curl --location 'https://api.ovac.pre.councilbox.com/graphql' \
--header 'Content-Type: application/json' \
--header 'x-jwt-token: {{token}}' \
--data '{"query":"mutation createOneOnOneCouncil($council: CouncilInput, $participant: ParticipantInput, $representation: ParticipantInput, $notifyCreation: Boolean, $checkAgenda: Boolean, $guests: [ParticipantInput]){ createOneOnOneCouncil(council: $council, participant: $participant, representation: $representation, notifyCreation: $notifyCreation, checkAgenda: $checkAgenda, guests: $guests) { id accessLink creatorId } }","variables":{"council":{"name":"test creación cita","companyExternalId":"EXT_COMP_2191","statuteExternalId":"EXT_STAT_4685","councilType":5,"externalId":"SISTEMA_EXTERNO_001","contactEmail":"","dateStart":"2026-05-16T15:00:00Z","conveneText":"","observations":"Estas son observaciones","internalNotes":"Estas son notas internas","language":"gal","comment":"","readOnly":0,"tag":"ADMIN"},"participant":{"name":"Name of participant","surname":"Surname of participant","idCardType":"dni","dni":"11111111H","idCardCountry":"ES","email":"participant_email@domain.com","phone":"+34600000000","language":"gal","zipcode":"00000"},"notifyCreation":true,"checkAgenda":true}}'

4. Respuesta Esperada (200 OK)

{
    "data": {
        "createOneOnOneCouncil": {
            "id": 64917,
            "accessLink": "https://apitest.ovac.pre.councilbox.com/attendance/token/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjb3VuY2lsUGFydGljaXBhbnRJZCI6MjQ5MDE2LCJpZCI6MjQ5MDE2LCJpYXQiOjE3NzkzNjE2Njl9.facpLzBhYA-KmDt9j2zMA32gMhyyBzUc47PNlSyFkaA",
            "creatorId": 3476
        }
    }
}

Nota OpenAPI/Fern: esta operación GraphQL se documenta como /graphql/createoneononecouncil-3 para que Fern pueda mostrarla como operación independiente. La ruta técnica real de ejecución es POST /graphql.