> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stardrift.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Add Event To Trip

> Record something scheduled that isn't a booking — a wedding, a concert.

add_place_to_guide would make it an attraction, which is what a place the
user might visit is, not something happening at a time they are expected at.
An event carries its own start and end, and its venue is geocoded to a pin
when one resolves. This is the same `add_event` the in-app Add-event flow
calls; only the authentication differs.



## OpenAPI

````yaml /openapi.json post /v1/trips/{trip_id}/events
openapi: 3.1.0
info:
  title: Stardrift API
  description: >-
    Read and edit the authenticated user's trips, itineraries, recorded
    bookings, and saved lists. Private records are owner-scoped. MCP tool names
    are documented separately from these HTTP operations.
  version: v1
servers:
  - url: https://stardrift.ai/api
security: []
paths:
  /v1/trips/{trip_id}/events:
    post:
      tags:
        - mcp-server
      summary: Add Event To Trip
      description: >-
        Record something scheduled that isn't a booking — a wedding, a concert.


        add_place_to_guide would make it an attraction, which is what a place
        the

        user might visit is, not something happening at a time they are expected
        at.

        An event carries its own start and end, and its venue is geocoded to a
        pin

        when one resolves. This is the same `add_event` the in-app Add-event
        flow

        calls; only the authentication differs.
      operationId: add_event_to_trip_v1_trips__trip_id__events_post
      parameters:
        - name: trip_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Trip Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AddEventRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AddEventResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    AddEventRequest:
      properties:
        name:
          type: string
          title: Name
        start_datetime:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Start Datetime
        end_datetime:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: End Datetime
        venue_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Venue Name
        address:
          anyOf:
            - type: string
            - type: 'null'
          title: Address
        place_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Place Id
        category:
          anyOf:
            - type: string
            - type: 'null'
          title: Category
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
        city:
          anyOf:
            - type: string
            - type: 'null'
          title: City
        total_price:
          anyOf:
            - type: number
            - type: 'null'
          title: Total Price
        currency:
          type: string
          title: Currency
          default: USD
        confirmation_number:
          anyOf:
            - type: string
            - type: 'null'
          title: Confirmation Number
      type: object
      required:
        - name
      title: AddEventRequest
    AddEventResponse:
      properties:
        activity_id:
          type: string
          title: Activity Id
        activity:
          additionalProperties: true
          type: object
          title: Activity
        warnings:
          items:
            type: string
          type: array
          title: Warnings
          default: []
      type: object
      required:
        - activity_id
        - activity
      title: AddEventResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError

````