Create Appointment Management_External | Councilbox OVAC API

Esta mutación permite registrar una nueva gestión desatendida en la plataforma con los identificadores externos, vinculando al ciudadano principal y configurando los metadatos de control y taxonomía del encuentro. Al crearse, el sistema genera de forma automática los enlaces de acceso tanto para los agentes como para los asistentes.

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

Parámetro	Descripción	Requerido	Tipo
$notifyCreation	`true`: Envía una notificación automática de confirmación al ciudadano. `false`: Registra la cita silenciosamente. Por defecto: `true`	NO	Boolean
$checkAgenda	`true`: Valida la disponibilidad horaria del agente antes de insertar. `false`: Omite la comprobación y fuerza la inserción.	SI	Boolean
$councilOptions.notificationType	Selecciona el método de notificación de la cita/gestión: `-1`: Sin notificación `0`: email `1`: SMS `2`: WhatsApp Si no se selecciona el bloque, se emplea el método por defecto configurado en el trámite.	NO	Integer
$council	Configuración técnica, fechas y taxonomía de la cita (Ver desglose abajo).	SI	Object
$participant	Datos de identidad y contacto del participante (Ver desglose abajo).	SI	Object
$representation	Datos del Representado. (Solo se rellena en flujos de representación legal).	NO	Object

Desglose del Objeto `council` (`CouncilInput`)

Parámetro	Descripción	Requerido	Tipo
name	Título o nombre asignado al trámite de la cita.	SI	String
companyExternalId	ID externo de la entidad.	SI	String
statuteExternalId	ID externo del trámite	SI	String
councilType	Canal de atención: `5` (Videoatención) `6` (Gestión desatendida) `7` (Presencial).	SI	Integer
dateStart	Fecha y hora programada en formato UTC bajo el estándar ISO 8601 (YYYY-MM-DDTHH:mmZ).	SI	String
tag	Identificador de origen: “`ADMIN`” (gestores) “`KIOSK`” (tótems) “`INMEDIATE`” (urgente) “`URGENT`” (huecos reservados).	SI	String
readOnly	Restricción de edición: `0` (permite modificaciones desde el portal) `1` (bloqueada, solo vía API).	SI	Integer
language	Idioma base en el que se configurará la cita(ej. “es”). Por defecto, se emplea el idioma configurado en la organización. Consultar método ‘`Languages`’.	NO	String
contactEmail	Correo electrónico de soporte o contacto de la entidad. Por defecto se usa el parametrizado en la entidad/organización.	NO	String
externalId	Identificador propio o ID único de la cita en el sistema del cliente.	NO	String
conveneText	Texto o cuerpo opcional para la convocatoria de la reunión.	NO	String
observations	Comentarios u observaciones generales de la cita.	NO	String
internalNotes	Notas internas dirigidas al agente (no son visibles por el ciudadano).	NO	String
comment	Comentarios adicionales sobre el registro.	NO	String

Desglose del Objeto `participant` (`ParticipantInput`)

Parámetro	Descripción	Requerido	Tipo
name	Nombre de pila del participante.	SI	String
surname	Apellidos completos del participante.	SI	Integer
idCardType	Tipo de documento de identidad. Valores admitidos: “`dni`”, “`nif`”, “`passport`”, “`nie`”, “`codiceFiscale`” (Identificador Italia), “`otherIDCards`” (cualquier documento de identificación), “`driversLicence`” (Licencia de conducir EEUU), “`europeanDocument`” (documento europeo, solo válido para los documentos de los países de europa)	SI	String
dni	Número del documento de identidad o identificación fiscal.	SI	String
idCardCountry	Código de país del documento en formato ISO 3166-1 alfa-2 (ej. “ES”).	SI	String
email	Dirección de correo electrónico donde el ciudadano recibirá las notificaciones.	SI	String
phone	Teléfono móvil de contacto con prefijo internacional (ej. “+34600000000”).	SI	String
language	Idioma en el que el ciudadano visualizará la interfaz de OVAC (ej. “es”). Por defecto, se obtiene el de la entidad/ogranización. Consultar método ‘`Languages`’.	NO	String
zipcode	Código postal de residencia del participante.	NO	String

Desglose del Objeto `agenda` (`[AgendaPointInput]`)

Parámetro	Descripción	Requerido	Tipo
agenda	Objeto de los pasos dentro de la cita	NO	Object
agenda.type	Tipo de paso a realizar: `9`: Consentimiento aceptación/rechazo	SI	Integer
agenda.name	Enunciado, título literal o descripción del consentimiento.	NO	String

Campos de Respuesta (Payload)

La respuesta exitosa devuelve el objeto createOneOnOneCouncil con los identificadores de acceso seguro:

Campo	Tipo	Descripción
`id`	Array	Identificador interno único de la cita generada en la plataforma OVAC.
`accessLink`	String	Enlace único de acceso directo (Tokenizado) para auditar, gestionar o iniciar la cita.
`creatorId`	Integer	Identificador único del usuario o API Key que ha dado de alta la cita.

Ejemplos de Código y Peticiones

1. Mutación GraphQL

1 mutation createOneOnOneCouncil(
2     $council: CouncilInput,
3     $participant: ParticipantInput,
4     $representation: ParticipantInput,
5     $notifyCreation: Boolean,
6     $checkAgenda: Boolean,
7     $guests: [ParticipantInput],
8     $councilOptions: CouncilOptions
9     $agenda: [AgendaPointInput]
10     )
11     {
12         createOneOnOneCouncil
13             (
14             council: $council,
15             participant: $participant,
16             representation: $representation,
17             notifyCreation: $notifyCreation,
18             checkAgenda: $checkAgenda,
19             guests: $guests
20             councilOptions: $councilOptions
21             agenda: $agenda
22             )
23         {
24             id
25             accessLink
26             creatorId
27         }
28     }

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

1 {
2     "council": {
3         "name": "Gestión desatendida con IdExterno",
4         "companyExternalId": "API_TEST",
5         "statuteExternalId": "GES001",
6         "councilType": 6,
7         "externalId" : "",
8         "contactEmail": "",
9         "dateStart": "2026-06-09T15:00Z",
10         "conveneText": "",
11         "observations": "",
12         "internalNotes": "",
13         "language":"es",
14         "comment": "",
15         "readOnly": 0,
16         "tag": "ADMIN"
17     },
18     "participant": {
19         "name": "Participante",
20         "surname": "Apellido1 Apellido2",
21         "idCardType": "dni",
22         "dni" : "77777777B",
23         "idCardCountry": "ES",
24         "email": "alejandro.maneiro@councilbox.com",
25         "phone": "+34600000000",
26         "language":"es",
27         "zipcode": "15883"
28     },
29     "agenda": [{
30         "type": 9,
31         "name": "La dirección proporcionada es Calle Nueva, número 7 en Teo, A Coruña CP 15883"
32     }],
33     "notifyCreation": true,
34     "checkAgenda": true,
35     "councilOptions": 
36         { 
37         "notificationType": 0 
38         }
39 }

3. Ejemplo de comando cURL

$ curl --location --globoff 'https://api.ovac.pre.councilbox.com/graphql' \
> --header 'Content-Type: application/json' \
> --header 'x-jwt-token: {{token}}' \
> --data-raw '{"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","companyId":2191,"statuteId":4685,"councilType":5,"externalId":"","contactEmail":"","dateStart":"2026-05-26T11: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}}'

4. Respuesta Esperada (200 OK)

1 {
2     "data": {
3         "createOneOnOneCouncil": {
4             "id": 64917,
5             "accessLink": "https://apitest.ovac.pre.councilbox.com/attendance/token/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjb3VuY2lsUGFydGljaXBhbnRJZCI6MjQ5MDE2LCJpZCI6MjQ5MDE2LCJpYXQiOjE3NzkzNjE2Njl9.facpLzBhYA-KmDt9j2zMA32gMhyyBzUc47PNlSyFkaA",
6             "creatorId": 3476
7         }
8     }
9 }

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

# Create Appointment Management_External (`createOneOnOneCouncil`) Esta mutación permite registrar una nueva gestión desatendida en la plataforma con los identificadores externos, vinculando al ciudadano principal y configurando los metadatos de control y taxonomía del encuentro. Al crearse, el sistema genera de forma automática los enlaces de acceso tanto para los agentes como para los asistentes. ### 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 | Parámetro | Descripción | Requerido | Tipo | | --- | --- | --- | --- | | $notifyCreation | `true`: Envía una notificación automática de confirmación al ciudadano. `false`: Registra la cita silenciosamente. Por defecto: `true` | NO | Boolean | | $checkAgenda | `true`: Valida la disponibilidad horaria del agente antes de insertar. `false`: Omite la comprobación y fuerza la inserción. | SI | Boolean | | $councilOptions.**notificationType** | Selecciona el método de notificación de la cita/gestión: `-1`: Sin notificación `0`: email `1`: SMS `2`: WhatsApp Si no se selecciona el bloque, se emplea el método por defecto configurado en el trámite. | NO | Integer | | $council | Configuración técnica, fechas y taxonomía de la cita (Ver desglose abajo). | SI | Object | | $participant | Datos de identidad y contacto del participante (Ver desglose abajo). | SI | Object | | $representation | Datos del Representado. (Solo se rellena en flujos de representación legal). | NO | Object | ### Desglose del Objeto `council` (`CouncilInput`) | Parámetro | Descripción | Requerido | Tipo | | --- | --- | --- | --- | | name | Título o nombre asignado al trámite de la cita. | SI | String | | companyExternalId | ID externo de la entidad. | SI | String | | statuteExternalId | ID externo del trámite | SI | String | | councilType | Canal de atención: `5` (Videoatención) `6` (Gestión desatendida) `7` (Presencial). | SI | Integer | | dateStart | Fecha y hora programada en formato UTC bajo el estándar ISO 8601 (YYYY-MM-DDTHH:mmZ). | SI | String | | tag | Identificador de origen: "`ADMIN`" (gestores) "`KIOSK`" (tótems) "`INMEDIATE`" (urgente) "`URGENT`" (huecos reservados). | SI | String | | readOnly | Restricción de edición: `0` (permite modificaciones desde el portal) `1` (bloqueada, solo vía API). | SI | Integer | | language | Idioma base en el que se configurará la cita(ej. "es"). Por defecto, se emplea el idioma configurado en la organización. Consultar método '`Languages`'. | NO | String | | contactEmail | Correo electrónico de soporte o contacto de la entidad. Por defecto se usa el parametrizado en la entidad/organización. | NO | String | | externalId | Identificador propio o ID único de la cita en el sistema del cliente. | NO | String | | conveneText | Texto o cuerpo opcional para la convocatoria de la reunión. | NO | String | | observations | Comentarios u observaciones generales de la cita. | NO | String | | internalNotes | Notas internas dirigidas al agente (no son visibles por el ciudadano). | NO | String | | comment | Comentarios adicionales sobre el registro. | NO | String | ### Desglose del Objeto `participant` (`ParticipantInput`) | Parámetro | Descripción | Requerido | Tipo | | --- | --- | --- | --- | | name | Nombre de pila del participante. | SI | String | | surname | Apellidos completos del participante. | SI | Integer | | idCardType | Tipo de documento de identidad. Valores admitidos: "`dni`", "`nif`", "`passport`", "`nie`", "`codiceFiscale`" (Identificador Italia), "`otherIDCards`" (cualquier documento de identificación), "`driversLicence`" (Licencia de conducir EEUU), "`europeanDocument`" (documento europeo, solo válido para los documentos de los países de europa) | SI | String | | dni | Número del documento de identidad o identificación fiscal. | SI | String | | idCardCountry | Código de país del documento en formato ISO 3166-1 alfa-2 (ej. "ES"). | SI | String | | email | Dirección de correo electrónico donde el ciudadano recibirá las notificaciones. | SI | String | | phone | Teléfono móvil de contacto con prefijo internacional (ej. "+34600000000"). | SI | String | | language | Idioma en el que el ciudadano visualizará la interfaz de OVAC (ej. "es"). Por defecto, se obtiene el de la entidad/ogranización. Consultar método '`Languages`'. | NO | String | | zipcode | Código postal de residencia del participante. | NO | String | ### Desglose del Objeto `agenda` (`[AgendaPointInput]`) | Parámetro | Descripción | Requerido | Tipo | | --- | --- | --- | --- | | agenda | Objeto de los pasos dentro de la cita | NO | Object | | agenda.**type** | Tipo de paso a realizar: `9`: Consentimiento aceptación/rechazo | SI | Integer | | agenda.**name** | Enunciado, título literal o descripción del consentimiento. | NO | String | ### Campos de Respuesta (Payload) La respuesta exitosa devuelve el objeto `createOneOnOneCouncil` con los identificadores de acceso seguro: | Campo | Tipo | Descripción | | --- | --- | --- | | **`id`** | Array | Identificador interno único de la cita generada en la plataforma OVAC. | | **`accessLink`** | String | Enlace único de acceso directo (Tokenizado) para auditar, gestionar o iniciar la cita. | | **`creatorId`** | Integer | Identificador único del usuario o API Key que ha dado de alta la cita. | ## Ejemplos de Código y Peticiones ### 1\. Mutación GraphQL ``` graphql mutation createOneOnOneCouncil( $council: CouncilInput, $participant: ParticipantInput, $representation: ParticipantInput, $notifyCreation: Boolean, $checkAgenda: Boolean, $guests: [ParticipantInput], $councilOptions: CouncilOptions $agenda: [AgendaPointInput] ) { createOneOnOneCouncil ( council: $council, participant: $participant, representation: $representation, notifyCreation: $notifyCreation, checkAgenda: $checkAgenda, guests: $guests councilOptions: $councilOptions agenda: $agenda ) { id accessLink creatorId } } ``` ### 2\. Variables de la Petición (JSON Payload) ``` json { "council": { "name": "Gestión desatendida con IdExterno", "companyExternalId": "API_TEST", "statuteExternalId": "GES001", "councilType": 6, "externalId" : "", "contactEmail": "", "dateStart": "2026-06-09T15:00Z", "conveneText": "", "observations": "", "internalNotes": "", "language":"es", "comment": "", "readOnly": 0, "tag": "ADMIN" }, "participant": { "name": "Participante", "surname": "Apellido1 Apellido2", "idCardType": "dni", "dni" : "77777777B", "idCardCountry": "ES", "email": "alejandro.maneiro@councilbox.com", "phone": "+34600000000", "language":"es", "zipcode": "15883" }, "agenda": [{ "type": 9, "name": "La dirección proporcionada es Calle Nueva, número 7 en Teo, A Coruña CP 15883" }], "notifyCreation": true, "checkAgenda": true, "councilOptions": { "notificationType": 0 } } ``` ### 3\. Ejemplo de comando cURL ``` bash curl --location --globoff 'https://api.ovac.pre.councilbox.com/graphql' \ --header 'Content-Type: application/json' \ --header 'x-jwt-token: {{token}}' \ --data-raw '{"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","companyId":2191,"statuteId":4685,"councilType":5,"externalId":"","contactEmail":"","dateStart":"2026-05-26T11: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}}' ``` ### 4\. Respuesta Esperada (200 OK) ``` json { "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-6` para que Fern pueda mostrarla como operación independiente. La ruta técnica real de ejecución es `POST /graphql`.

Authentication

x-jwt-tokenstring

JWT token obtained from Login.

Request

This endpoint expects an object.

querystringRequired

GraphQL operation

variablesobjectOptional

GraphQL variables

Response

Successful response. GraphQL business errors may be returned inside the JSON errors field while transport status remains HTTP 200.

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

Parámetro	Descripción	Requerido	Tipo
$notifyCreation	`true`: Envía una notificación automática de confirmación al ciudadano. `false`: Registra la cita silenciosamente. Por defecto: `true`	NO	Boolean
$checkAgenda	`true`: Valida la disponibilidad horaria del agente antes de insertar. `false`: Omite la comprobación y fuerza la inserción.	SI	Boolean
$councilOptions.notificationType	Selecciona el método de notificación de la cita/gestión: `-1`: Sin notificación `0`: email `1`: SMS `2`: WhatsApp Si no se selecciona el bloque, se emplea el método por defecto configurado en el trámite.	NO	Integer
$council	Configuración técnica, fechas y taxonomía de la cita (Ver desglose abajo).	SI	Object
$participant	Datos de identidad y contacto del participante (Ver desglose abajo).	SI	Object
$representation	Datos del Representado. (Solo se rellena en flujos de representación legal).	NO	Object

Desglose del Objeto `council` (`CouncilInput`)

Parámetro	Descripción	Requerido	Tipo
name	Título o nombre asignado al trámite de la cita.	SI	String
companyExternalId	ID externo de la entidad.	SI	String
statuteExternalId	ID externo del trámite	SI	String
councilType	Canal de atención: `5` (Videoatención) `6` (Gestión desatendida) `7` (Presencial).	SI	Integer
dateStart	Fecha y hora programada en formato UTC bajo el estándar ISO 8601 (YYYY-MM-DDTHH:mmZ).	SI	String
tag	Identificador de origen: “`ADMIN`” (gestores) “`KIOSK`” (tótems) “`INMEDIATE`” (urgente) “`URGENT`” (huecos reservados).	SI	String
readOnly	Restricción de edición: `0` (permite modificaciones desde el portal) `1` (bloqueada, solo vía API).	SI	Integer
language	Idioma base en el que se configurará la cita(ej. “es”). Por defecto, se emplea el idioma configurado en la organización. Consultar método ‘`Languages`’.	NO	String
contactEmail	Correo electrónico de soporte o contacto de la entidad. Por defecto se usa el parametrizado en la entidad/organización.	NO	String
externalId	Identificador propio o ID único de la cita en el sistema del cliente.	NO	String
conveneText	Texto o cuerpo opcional para la convocatoria de la reunión.	NO	String
observations	Comentarios u observaciones generales de la cita.	NO	String
internalNotes	Notas internas dirigidas al agente (no son visibles por el ciudadano).	NO	String
comment	Comentarios adicionales sobre el registro.	NO	String

Desglose del Objeto `participant` (`ParticipantInput`)

Parámetro	Descripción	Requerido	Tipo
name	Nombre de pila del participante.	SI	String
surname	Apellidos completos del participante.	SI	Integer
idCardType	Tipo de documento de identidad. Valores admitidos: “`dni`”, “`nif`”, “`passport`”, “`nie`”, “`codiceFiscale`” (Identificador Italia), “`otherIDCards`” (cualquier documento de identificación), “`driversLicence`” (Licencia de conducir EEUU), “`europeanDocument`” (documento europeo, solo válido para los documentos de los países de europa)	SI	String
dni	Número del documento de identidad o identificación fiscal.	SI	String
idCardCountry	Código de país del documento en formato ISO 3166-1 alfa-2 (ej. “ES”).	SI	String
email	Dirección de correo electrónico donde el ciudadano recibirá las notificaciones.	SI	String
phone	Teléfono móvil de contacto con prefijo internacional (ej. “+34600000000”).	SI	String
language	Idioma en el que el ciudadano visualizará la interfaz de OVAC (ej. “es”). Por defecto, se obtiene el de la entidad/ogranización. Consultar método ‘`Languages`’.	NO	String
zipcode	Código postal de residencia del participante.	NO	String

Desglose del Objeto `agenda` (`[AgendaPointInput]`)

Parámetro	Descripción	Requerido	Tipo
agenda	Objeto de los pasos dentro de la cita	NO	Object
agenda.type	Tipo de paso a realizar: `9`: Consentimiento aceptación/rechazo	SI	Integer
agenda.name	Enunciado, título literal o descripción del consentimiento.	NO	String

Campos de Respuesta (Payload)

La respuesta exitosa devuelve el objeto createOneOnOneCouncil con los identificadores de acceso seguro:

Campo	Tipo	Descripción
`id`	Array	Identificador interno único de la cita generada en la plataforma OVAC.
`accessLink`	String	Enlace único de acceso directo (Tokenizado) para auditar, gestionar o iniciar la cita.
`creatorId`	Integer	Identificador único del usuario o API Key que ha dado de alta la cita.

Ejemplos de Código y Peticiones

1. Mutación GraphQL

1 mutation createOneOnOneCouncil(
2     $council: CouncilInput,
3     $participant: ParticipantInput,
4     $representation: ParticipantInput,
5     $notifyCreation: Boolean,
6     $checkAgenda: Boolean,
7     $guests: [ParticipantInput],
8     $councilOptions: CouncilOptions
9     $agenda: [AgendaPointInput]
10     )
11     {
12         createOneOnOneCouncil
13             (
14             council: $council,
15             participant: $participant,
16             representation: $representation,
17             notifyCreation: $notifyCreation,
18             checkAgenda: $checkAgenda,
19             guests: $guests
20             councilOptions: $councilOptions
21             agenda: $agenda
22             )
23         {
24             id
25             accessLink
26             creatorId
27         }
28     }

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

1 {
2     "council": {
3         "name": "Gestión desatendida con IdExterno",
4         "companyExternalId": "API_TEST",
5         "statuteExternalId": "GES001",
6         "councilType": 6,
7         "externalId" : "",
8         "contactEmail": "",
9         "dateStart": "2026-06-09T15:00Z",
10         "conveneText": "",
11         "observations": "",
12         "internalNotes": "",
13         "language":"es",
14         "comment": "",
15         "readOnly": 0,
16         "tag": "ADMIN"
17     },
18     "participant": {
19         "name": "Participante",
20         "surname": "Apellido1 Apellido2",
21         "idCardType": "dni",
22         "dni" : "77777777B",
23         "idCardCountry": "ES",
24         "email": "alejandro.maneiro@councilbox.com",
25         "phone": "+34600000000",
26         "language":"es",
27         "zipcode": "15883"
28     },
29     "agenda": [{
30         "type": 9,
31         "name": "La dirección proporcionada es Calle Nueva, número 7 en Teo, A Coruña CP 15883"
32     }],
33     "notifyCreation": true,
34     "checkAgenda": true,
35     "councilOptions": 
36         { 
37         "notificationType": 0 
38         }
39 }

3. Ejemplo de comando cURL

$ curl --location --globoff 'https://api.ovac.pre.councilbox.com/graphql' \
> --header 'Content-Type: application/json' \
> --header 'x-jwt-token: {{token}}' \
> --data-raw '{"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","companyId":2191,"statuteId":4685,"councilType":5,"externalId":"","contactEmail":"","dateStart":"2026-05-26T11: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}}'

4. Respuesta Esperada (200 OK)

1 {
2     "data": {
3         "createOneOnOneCouncil": {
4             "id": 64917,
5             "accessLink": "https://apitest.ovac.pre.councilbox.com/attendance/token/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjb3VuY2lsUGFydGljaXBhbnRJZCI6MjQ5MDE2LCJpZCI6MjQ5MDE2LCJpYXQiOjE3NzkzNjE2Njl9.facpLzBhYA-KmDt9j2zMA32gMhyyBzUc47PNlSyFkaA",
6             "creatorId": 3476
7         }
8     }
9 }

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

1	mutation createOneOnOneCouncil(
2	$council: CouncilInput,
3	$participant: ParticipantInput,
4	$representation: ParticipantInput,
5	$notifyCreation: Boolean,
6	$checkAgenda: Boolean,
7	$guests: [ParticipantInput],
8	$councilOptions: CouncilOptions
9	$agenda: [AgendaPointInput]
10	)
11	{
12	createOneOnOneCouncil
13	(
14	council: $council,
15	participant: $participant,
16	representation: $representation,
17	notifyCreation: $notifyCreation,
18	checkAgenda: $checkAgenda,
19	guests: $guests
20	councilOptions: $councilOptions
21	agenda: $agenda
22	)
23	{
24	id
25	accessLink
26	creatorId
27	}
28	}

1	{
2	"council": {
3	"name": "Gestión desatendida con IdExterno",
4	"companyExternalId": "API_TEST",
5	"statuteExternalId": "GES001",
6	"councilType": 6,
7	"externalId" : "",
8	"contactEmail": "",
9	"dateStart": "2026-06-09T15:00Z",
10	"conveneText": "",
11	"observations": "",
12	"internalNotes": "",
13	"language":"es",
14	"comment": "",
15	"readOnly": 0,
16	"tag": "ADMIN"
17	},
18	"participant": {
19	"name": "Participante",
20	"surname": "Apellido1 Apellido2",
21	"idCardType": "dni",
22	"dni" : "77777777B",
23	"idCardCountry": "ES",
24	"email": "alejandro.maneiro@councilbox.com",
25	"phone": "+34600000000",
26	"language":"es",
27	"zipcode": "15883"
28	},
29	"agenda": [{
30	"type": 9,
31	"name": "La dirección proporcionada es Calle Nueva, número 7 en Teo, A Coruña CP 15883"
32	}],
33	"notifyCreation": true,
34	"checkAgenda": true,
35	"councilOptions":
36	{
37	"notificationType": 0
38	}
39	}

$	curl --location --globoff 'https://api.ovac.pre.councilbox.com/graphql' \
>	--header 'Content-Type: application/json' \
>	--header 'x-jwt-token: {{token}}' \
>	--data-raw '{"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","companyId":2191,"statuteId":4685,"councilType":5,"externalId":"","contactEmail":"","dateStart":"2026-05-26T11: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}}'

1	{
2	"data": {
3	"createOneOnOneCouncil": {
4	"id": 64917,
5	"accessLink": "https://apitest.ovac.pre.councilbox.com/attendance/token/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjb3VuY2lsUGFydGljaXBhbnRJZCI6MjQ5MDE2LCJpZCI6MjQ5MDE2LCJpYXQiOjE3NzkzNjE2Njl9.facpLzBhYA-KmDt9j2zMA32gMhyyBzUc47PNlSyFkaA",
6	"creatorId": 3476
7	}
8	}
9	}

Autenticación

Referencia de la API

Variables Globales de Entrada

Desglose del Objeto council (CouncilInput)

Desglose del Objeto participant (ParticipantInput)

Desglose del Objeto agenda ([AgendaPointInput])

Campos de Respuesta (Payload)

Ejemplos de Código y Peticiones

1. Mutación GraphQL

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

3. Ejemplo de comando cURL

4. Respuesta Esperada (200 OK)

Authentication

Request

Response

Autenticación

Referencia de la API

Variables Globales de Entrada

Desglose del Objeto council (CouncilInput)

Desglose del Objeto participant (ParticipantInput)

Desglose del Objeto agenda ([AgendaPointInput])

Campos de Respuesta (Payload)

Ejemplos de Código y Peticiones

1. Mutación GraphQL

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

3. Ejemplo de comando cURL

4. Respuesta Esperada (200 OK)

Desglose del Objeto `council` (`CouncilInput`)

Desglose del Objeto `participant` (`ParticipantInput`)

Desglose del Objeto `agenda` (`[AgendaPointInput]`)

Desglose del Objeto `council` (`CouncilInput`)

Desglose del Objeto `participant` (`ParticipantInput`)

Desglose del Objeto `agenda` (`[AgendaPointInput]`)