Booking created without adding guests

[nfaganelly]

Description

I am experiencing an issue when trying to schedule meetings with guests using the Cal.com API. Although the booking is successfully created, the guests are not added, even when specified in the request body.

Steps to Reproduce

1. Send a POST request to http://cal.com/v1/bookings with the following body:

{
  "start": "2024-10-19T14:00:00-03:00",
  "eventTypeId": 1244419,
  "timeZone": "America/Sao_Paulo",
  "language": "pt",
  "metadata": {},
  "responses": {
    "name": "Bruno",
    "email": "[email protected]",
    "guests": ["[email protected]"],
    "notes": "Reunião para discutir integração de IA no processo de vendas de TV por assinatura."
  }
}

2. Check the API response and notice that the booking is created, but the guest is not added.

cURL Used

curl --location 'http://cal.com/v1/bookings' \
--data-raw '{
  "start": "2024-10-19T14:00:00-03:00",
  "eventTypeId": 1244909,
  "timeZone": "America/Sao_Paulo",
  "language": "pt",
  "metadata": {},
  "responses": {
    "name": "Bruno",
    "email": "[email protected]",
    "guests": ["[email protected]"],
    "notes": "Reunião para discutir integração de IA no processo de vendas de TV por assinatura."
  }
}'

Expected Behavior

I expected the guest specified in the guests field to be added to the booking.

Actual Behavior

The booking is created, but the guest is not added.

Environment

• API Version: v1

Response Example

{
  "id": 3776167,
  "uid": "hidden_uid",
  "idempotencyKey": "hidden_idempotencyKey",
  "userId": 985751,
  "userPrimaryEmail": "[email protected]",
  "eventTypeId": 1244405,
  "title": "Consultoria de IA - Flly IA e Automações com Nícolas Faganelly",
  "description": "Lead interessado em otimização de processos com IA para um volume de 9.000 leads mensais e possui 27 colaboradores. Novo convidado adicionado: [email protected].",
  "customInputs": {},
  "responses": {
    "name": "Bruno",
    "email": "[email protected]",
    "notes": "Lead interessado em otimização de processos com IA para um volume de 9.000 leads mensais e possui 27 colaboradores. Novo convidado adicionado: [email protected].",
    "guests": []
  },
  "startTime": "2024-10-19T17:00:00.000Z",
  "endTime": "2024-10-19T18:00:00.000Z",
  "location": "integrations:google:meet",
  "createdAt": "2024-10-18T18:33:00.352Z",
  "updatedAt": null,
  "status": "ACCEPTED",
  "paid": false,
  "destinationCalendarId": 350453,
  "cancellationReason": null,
  "rejectionReason": null,
  "dynamicEventSlugRef": null,
  "dynamicGroupSlugRef": null,
  "rescheduled": null,
  "fromReschedule": null,
  "recurringEventId": null,
  "smsReminderNumber": null,
  "scheduledJobs": [],
  "metadata": {},
  "isRecorded": false,
  "iCalUID": "[email protected]",
  "iCalSequence": 0,
  "rating": null,
  "ratingFeedback": null,
  "noShowHost": false,
  "oneTimePassword": null,
  "cancelledBy": null,
  "rescheduledBy": null,
  "user": {
    "email": null,
    "name": "Flly IA",
    "timeZone": "America/Sao_Paulo",
    "username": "fllyia"
  },
  "attendees": [
    {
      "id": 4314414,
      "email": "[email protected]",
      "name": "Bruno",
      "timeZone": "America/Sao_Paulo",
      "phoneNumber": null,
      "locale": "pt",
      "bookingId": 3776167,
      "noShow": false
    }
  ]
}

Summary

• Problem: Guests are not added to the booking.
• Steps to Reproduce: Send a request with the guests field populated.
• Actual Behavior: Booking created without guests.
• Expected Behavior: Booking created with guests added.

[dosubot[bot]]

The issue you're experiencing with guests not being added to the booking might be due to a couple of reasons related to the Cal.com API:

1. Permission Issues: Ensure that the user making the request has the necessary permissions. The user must be a team admin, team owner, organizer, or an attendee of the booking. Without these roles, guests cannot be added, and a FORBIDDEN error would typically be thrown ^[1].

2. Email Validation: The guests' emails must be unique and not already present in the booking's attendees list. Additionally, ensure that the emails are not blacklisted in the BLACKLISTED_GUEST_EMAILS environment variable. If the emails are duplicates or blacklisted, a BAD_REQUEST error with the message "emails_must_be_unique_valid" would be thrown ^[1].

3. Request Body Structure: The structure of your request body might not align with the expected format for adding guests. The guests field should be a separate array outside of the responses object. Here's the correct structure:

   {
     "start": "2024-10-19T14:00:00-03:00",
     "eventTypeId": 1244419,
     "attendee": {
       "name": "Bruno",
       "email": "[email protected]",
       "timeZone": "America/Sao_Paulo"
     },
     "guests": ["[email protected]"],
     "location": "integrations:google:meet",
     "bookingFieldsResponses": {
       "notes": "Reunião para discutir integração de IA no processo de vendas de TV por assinatura."
     }
   }

Make sure to adjust your request body accordingly and verify the permissions and email validity to resolve the issue.

To continue talking to Dosu, mention @dosu.

Written by @dosu, approved by dosu-customer-success

[nfaganelly]

O problema que você está enfrentando com hóspedes não sendo adicionados à reserva pode ser devido a alguns motivos relacionados à API do Cal.com:

1. Problemas de permissão : certifique-se de que o usuário que faz a solicitação tenha as permissões necessárias. O usuário deve ser um administrador de equipe, proprietário de equipe, organizador ou um participante da reserva. Sem essas funções, os convidados não podem ser adicionados e um FORBIDDENerro normalmente seria lançado [1] .
2. Validação de e-mail : os e-mails dos hóspedes devem ser únicos e não estar presentes na lista de participantes da reserva. Além disso, garanta que os e-mails não estejam na lista negra da BLACKLISTED_GUEST_EMAILSvariável de ambiente. Se os e-mails forem duplicados ou estiverem na lista negra, um BAD_REQUESTerro com a mensagem "emails_must_be_unique_valid" será lançado [1] .
3. Estrutura do corpo da solicitação : A estrutura do corpo da sua solicitação pode não estar alinhada com o formato esperado para adicionar convidados. O guestscampo deve ser uma matriz separada fora do responsesobjeto. Aqui está a estrutura correta:

   {
     "start": "2024-10-19T14:00:00-03:00",
     "eventTypeId": 1244419,
     "attendee": {
       "name": "Bruno",
       "email": "[email protected]",
       "timeZone": "America/Sao_Paulo"
     },
     "guests": ["[email protected]"],
     "location": "integrations:google:meet",
     "bookingFieldsResponses": {
       "notes": "Reunião para discutir integração de IA no processo de vendas de TV por assinatura."
     }
   }

Certifique-se de ajustar o corpo da solicitação adequadamente e verificar as permissões e a validade do e-mail para resolver o problema.

Para continuar falando com Dosu , mencione@dosu.

Escrito por@dosu, aprovado por dosu-customer-success

"Request body structure: The structure of your request body may not match the expected format for the requested addition. The guests field must be a separate array outside of the response object."

Are you sure? The documentation says it must be inside 'response'