> ## Documentation Index > Fetch the complete documentation index at: https://www.carstoragesoftware.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Create appointment > Requires `write:appointments`. Schedule an event for later: pass `eventTypeId` or `eventType` (the event type `value`) from `GET /event-types`, or an `appointmentTypeId`. Typed appointments get their event session created right away. No parking sync — to do an event now (e.g. Vehicle Drop Off into a spot), use `POST /cars/{id}/events`. ## OpenAPI ````yaml /api-reference/openapi.json post /api/v1/appointments openapi: 3.0.0 info: title: Car Storage Software API version: 1.1.0 description: >- Team-scoped REST API for Car Storage Software. Authenticate with a team API key (`Authorization: Bearer ` or `x-api-key: `) created under Settings → Integrations → API. Keys carry granular `read:*` / `write:*` scopes; read never implies write. servers: - url: https://www.carstoragesoftware.com security: [] paths: /api/v1/appointments: post: tags: - Appointments summary: Create appointment description: >- Requires `write:appointments`. Schedule an event for later: pass `eventTypeId` or `eventType` (the event type `value`) from `GET /event-types`, or an `appointmentTypeId`. Typed appointments get their event session created right away. No parking sync — to do an event now (e.g. Vehicle Drop Off into a spot), use `POST /cars/{id}/events`. requestBody: content: application/json: schema: $ref: '#/components/schemas/V1AppointmentCreate' responses: '201': description: Created. content: application/json: schema: $ref: '#/components/schemas/V1AppointmentResponse' '401': description: Missing, invalid, revoked, or expired API key. content: application/json: schema: $ref: '#/components/schemas/ApiError' '403': description: API key missing required scope, or API disabled for team. content: application/json: schema: $ref: '#/components/schemas/ApiError' '404': description: Resource not found. content: application/json: schema: $ref: '#/components/schemas/ApiError' '422': description: Request validation failed. content: application/json: schema: $ref: '#/components/schemas/ApiError' security: - ApiKeyAuth: [] components: schemas: V1AppointmentCreate: type: object properties: startAt: type: string format: date-time endAt: type: string format: date-time title: type: string nullable: true notes: type: string nullable: true status: type: string enum: - scheduled - pending_approval - accepted - declined - checked_in - in_progress - completed - cancelled - no_show locationId: type: string nullable: true format: uuid appointmentTypeId: type: string nullable: true format: uuid optionId: type: string nullable: true format: uuid carId: type: string nullable: true format: uuid secondaryCarId: type: string nullable: true format: uuid customerId: type: string nullable: true format: uuid recurrenceFrequency: type: string nullable: true enum: - daily - weekly - biweekly - monthly - quarterly - yearly - null recurrenceInterval: type: integer nullable: true minimum: 1 recurrenceDaysOfWeek: type: array nullable: true items: type: integer minimum: 0 maximum: 6 recurrenceDayOfMonth: type: integer nullable: true minimum: 1 maximum: 31 recurrenceEndDate: type: string nullable: true format: date-time recurrenceCount: type: integer nullable: true minimum: 1 recurrenceSeriesId: type: string nullable: true format: uuid eventTypeId: type: string format: uuid description: >- Event type id from GET /event-types. Alternative to appointmentTypeId. eventType: type: string minLength: 1 description: >- Event type `value` (e.g. `vehicle_pick_up`). Alternative to eventTypeId. required: - startAt - endAt V1AppointmentResponse: type: object properties: data: $ref: '#/components/schemas/V1Appointment' required: - data ApiError: type: object properties: error: type: string code: type: string details: nullable: true required: - error V1Appointment: type: object properties: id: type: string format: uuid teamId: type: string locationId: type: string nullable: true format: uuid appointmentTypeId: type: string nullable: true format: uuid optionId: type: string nullable: true format: uuid status: type: string enum: - scheduled - pending_approval - accepted - declined - checked_in - in_progress - completed - cancelled - no_show carId: type: string nullable: true format: uuid secondaryCarId: type: string nullable: true format: uuid customerId: type: string nullable: true format: uuid startAt: type: string nullable: true format: date-time endAt: type: string nullable: true format: date-time title: type: string nullable: true notes: type: string nullable: true recurrenceFrequency: type: string nullable: true enum: - daily - weekly - biweekly - monthly - quarterly - yearly - null recurrenceInterval: type: integer nullable: true recurrenceDaysOfWeek: type: array nullable: true items: type: integer recurrenceDayOfMonth: type: integer nullable: true recurrenceEndDate: type: string nullable: true format: date-time recurrenceCount: type: integer nullable: true recurrenceSeriesId: type: string nullable: true format: uuid createdAt: type: string nullable: true format: date-time updatedAt: type: string nullable: true format: date-time required: - id - teamId - locationId - appointmentTypeId - optionId - status - carId - secondaryCarId - customerId - startAt - endAt - title - notes - recurrenceFrequency - recurrenceInterval - recurrenceDaysOfWeek - recurrenceDayOfMonth - recurrenceEndDate - recurrenceCount - recurrenceSeriesId - createdAt - updatedAt securitySchemes: ApiKeyAuth: type: http scheme: bearer bearerFormat: API Key description: >- Team API key from Settings → Integrations. Use `Authorization: Bearer ` or `x-api-key`. ```` ## Related topics - [Create an appointment](/docs/schedule/create-an-appointment.md) - [Create recurring appointments](/docs/schedule/create-recurring-appointments.md) - [Test an event setup](/docs/events/test-an-event-setup.md) - [Create an all-day event](/docs/schedule/create-an-all-day-event.md) - [Create operations workflows](/docs/settings/create-operations-workflows.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.