# Create Appointment

Use the `createAppointment` mutation to schedule a user appointment.

### Arguments

|   Argument Name   |         Type        |                                                                                                    Description                                                                                                   |
| :---------------: | :-----------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
| **Argument Name** |       **Type**      |                                                                                                  **Description**                                                                                                 |
| `appointmentType` |         ID!         |                                                                            ID of the appointment type defined on the coaching portal.                                                                            |
|      `coach`      |          ID         |                                                                                 ID of the coach used to schedule the appointment.                                                                                |
|     `datetime`    |      DateTime!      |                                                                         Use this to send the exact number of credits the user will have.                                                                         |
|   `contactType`   | CalendarContactType |                                                <p>Default "VIDEO\_CALL", enum CalendarContactType {<br>VIDEO\_CALL<br>GOOGLE\_MEET<br>ZOOM<br>PHONE\_CALL<br>}</p>                                               |
|       `note`      |        String       |                                                                                              Optional meeting notes.                                                                                             |
| `postEventStatus` |   PostEventStatus   | enum PostEventStatus { SCHEDULED COMPLETED MEMBER\_NO\_SHOW COACH\_NO\_SHOW RESCHEDULED\_BY\_MEMBER RESCHEDULED\_BY\_COACH RESCHEDULED\_BY\_ADMIN CANCELED\_BY\_MEMBER CANCELED\_BY\_COACH CANCELED\_BY\_ADMIN } |

### Available Fields

|   Field Name   |     Type    |                                                        Description                                                       |
| :------------: | :---------: | :----------------------------------------------------------------------------------------------------------------------: |
| **Field Name** |   **Type**  |                                                      **Description**                                                     |
|  `appointment` | Appointment | A structured version of the [appointment  details](https://docs.suggestic.com/graphql/objects/appointments/appointment). |
|    `message`   |   Boolean   |                     **True** if the appointment  has been created successfully. Otherwise, **False**                     |
|    `success`   |   Boolean   |                                                 Description of the result                                                |

### Example

{% tabs %}
{% tab title="Request" %}

```graphql
mutation{
  createAppointment(input:{
    appointmentType:"QXBwb2ludG1lbnRUeXBlOjEwNjM="
    coach:"Q29hY2g6ODgwOA=="
    datetime:"2025-10-09T14:30:00+00:00"
    contactType:VIDEO_CALL
  }){
    success
    message
    appointment{
      id
      start
      end
      title
      appointmentType{
        title
        id
      }
    }
  }
}
```

{% endtab %}

{% tab title="Response" %}

```graphql
{
  "data": {
    "createAppointment": {
      "success": true,
      "message": "Appointment created",
      "appointment": {
        "id": "QXBwb2ludG1lbnQ6MzI4MDA=",
        "start": "2025-10-09T14:30:00+00:00",
        "end": "2025-10-09T15:00:00+00:00",
        "title": "Test",
        "appointmentType": {
          "title": "Test",
          "id": "QXBwb2ludG1lbnRUeXBlOjEwNjM="
        }
      }
    }
  }
}
```

{% endtab %}
{% endtabs %}