Apptoto Event API

The Event API from Apptoto — 3 operation(s) for event.

Operations 3

GET /v1/event /v1/event #
POST /v1/event/mark /v1/event/mark #
POST /v1/event/tag /v1/event/tag #

Specifications

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/apptoto:apptoto-event-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

apptoto-event-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: api-settings Event API
  version: '1.0'
servers:
- url: https://api.apptoto.com
security:
- sec0: []
- sec1: []
tags:
- name: Event
paths:
  /v1/event:
    get:
      summary: /v1/event
      description: 'Fetch one event using an id.


        Either id or external_id param'
      operationId: v1event
      parameters:
      - name: id
        in: query
        description: The Apptoto id for the event
        required: true
        schema:
          type: integer
          format: int32
      - name: external_id
        in: query
        description: Your unique external id for the event.  REQUIRED if you do not specify an id
        schema:
          type: string
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n  \"id\": 123,\n  \"calendar_id\": 456,\n  \"start_time\": \"2016-04-15T12:00:00-07:00\",\n  \"end_time\": \"2016-04-15T13:00:00-07:00\",\n  \"title\": \"Appointment with Fred\",\n  \"location\": \"\",\n  \"content\": \"\",\n  \"is_deleted\": false,\n  \"participants\": [\n    {\n      \"id\": 789,\n      \"name\": \"Fred Smith\",\n      \"phone\": \"650-555-1212\",\n      \"normalized_phone\": \"+16505551212\",\n      \"email\": \"fred@gmail.com\",\n      \"state\": \"initial\"\n    }\n  ],\n  \"custom_data\": {\n    \"field_1\": \"custom value\"\n  }\n}"
              schema:
                type: object
                properties:
                  id:
                    type: integer
                    example: 123
                    default: 0
                  calendar_id:
                    type: integer
                    example: 456
                    default: 0
                  start_time:
                    type: string
                    example: '2016-04-15T12:00:00-07:00'
                  end_time:
                    type: string
                    example: '2016-04-15T13:00:00-07:00'
                  title:
                    type: string
                    example: Appointment with Fred
                  location:
                    type: string
                    example: ''
                  content:
                    type: string
                    example: ''
                  is_deleted:
                    type: boolean
                    example: false
                    default: true
                  participants:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: integer
                          example: 789
                          default: 0
                        name:
                          type: string
                          example: Fred Smith
                        phone:
                          type: string
                          example: 650-555-1212
                        normalized_phone:
                          type: string
                          example: '+16505551212'
                        email:
                          type: string
                          example: fred@gmail.com
                        state:
                          type: string
                          example: initial
                  custom_data:
                    type: object
                    properties:
                      field_1:
                        type: string
                        example: custom value
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                type: object
                properties: {}
      deprecated: false
      security:
      - sec0: []
      - sec1:
        - events:read
      tags:
      - Event
  /v1/event/mark:
    post:
      summary: /v1/event/mark
      description: Mark all the participants on one event as confirmed, cancelled, etc.
      operationId: v1eventmark
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
              - id
              properties:
                id:
                  type: string
                  description: The Apptoto id for the vent
                external_id:
                  type: string
                  description: Your unique external id for the event.  REQUIRED if you do not specify an id
                state:
                  type: string
                  description: The state to set the participants to
      deprecated: false
      security:
      - sec0: []
      - sec1:
        - events:write
      tags:
      - Event
  /v1/event/tag:
    post:
      summary: /v1/event/tag
      description: 'Add or remove a tag on one event. The tag is appended to the end of the event title as a hashtag (e.g. "Haircut" becomes "Haircut #qualified") and is also tracked in the event''s tags field.'
      operationId: v1eventtag
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
              - tag
              properties:
                id:
                  type: string
                  description: The Apptoto id for the event
                external_id:
                  type: string
                  description: Your unique external id for the event.  REQUIRED if you do not specify an id
                tag:
                  type: string
                  description: 'The tag to add or remove. A leading # is optional and is added automatically (e.g. "qualified" and "#qualified" are equivalent).'
                remove:
                  type: string
                  description: Set to "true" to remove the tag instead of adding it. Defaults to adding the tag.
      deprecated: false
      security:
      - sec0: []
      - sec1:
        - events:write
      tags:
      - Event
components:
  securitySchemes:
    sec0:
      type: http
      scheme: basic
    sec1:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://www.apptoto.com/oauth/authorize
          tokenUrl: https://api.apptoto.com/oauth/token
          refreshUrl: https://api.apptoto.com/oauth/token
          scopes:
            calendars:read: View calendars
            address_books:read: View address books
            contacts:read: View contacts
            contacts:write: Create, update, and delete contacts
            events:read: View calendar events
            events:write: Create, update, and delete events; mark event statuses
            bookings:read: View booking page availability and existing bookings
            bookings:write: Create bookings on booking pages
            imports:read: Check the status of imports
            imports:write: Upload imports (CSV / ICS / XML) that bulk-create data
            lists:read: View opt-in and opt-out lists
            lists:write: Modify opt-in and opt-out lists
            messaging:read: View conversations and message history
            messaging:send: Send SMS or email messages on the user's behalf
            webhooks:read: View webhooks
            webhooks:write: Create, update, and delete webhooks that send account activity to other services
x-readme-fauxas: true
x-provenance:
  method: searched
  source: https://apidocs.apptoto.com/reference
  harvested: '2026-10-28'
  tool: harvest-readme-openapi.py
  note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
  assembled_from:
  - https://apidocs.apptoto.com/reference/import-upload.md
  - https://apidocs.apptoto.com/reference/v1address_books.md
  - https://apidocs.apptoto.com/reference/v1availability.md
  - https://apidocs.apptoto.com/reference/v1book_now-1.md
  - https://apidocs.apptoto.com/reference/v1booking_pages.md
  - https://apidocs.apptoto.com/reference/v1bookings.md
  - https://apidocs.apptoto.com/reference/v1calendars-1.md
  - https://apidocs.apptoto.com/reference/v1contact.md
  - https://apidocs.apptoto.com/reference/v1contacts-1.md
  - https://apidocs.apptoto.com/reference/v1contacts-2.md
  - https://apidocs.apptoto.com/reference/v1contacts-3.md
  - https://apidocs.apptoto.com/reference/v1contacts.md
  - https://apidocs.apptoto.com/reference/v1contactstag.md
  - https://apidocs.apptoto.com/reference/v1conversation_messages.md
  - https://apidocs.apptoto.com/reference/v1conversation_reply.md
  - https://apidocs.apptoto.com/reference/v1conversation_templates.md
  - https://apidocs.apptoto.com/reference/v1conversations.md
  - https://apidocs.apptoto.com/reference/v1event.md
  - https://apidocs.apptoto.com/reference/v1eventmark.md
  - https://apidocs.apptoto.com/reference/v1events-1.md
  - https://apidocs.apptoto.com/reference/v1events-2.md
  - https://apidocs.apptoto.com/reference/v1events-3.md
  - https://apidocs.apptoto.com/reference/v1events.md
  - https://apidocs.apptoto.com/reference/v1eventtag.md
  - https://apidocs.apptoto.com/reference/v1import.md
  - https://apidocs.apptoto.com/reference/v1lists-1.md
  - https://apidocs.apptoto.com/reference/v1lists-2.md
  - https://apidocs.apptoto.com/reference/v1lists-3.md
  - https://apidocs.apptoto.com/reference/v1lists.md
  - https://apidocs.apptoto.com/reference/v1participantmark.md
  - https://apidocs.apptoto.com/reference/v1participants-1.md
  - https://apidocs.apptoto.com/reference/v1participants-2.md
  - https://apidocs.apptoto.com/reference/v1participants-3.md
  - https://apidocs.apptoto.com/reference/v1participants.md
  - https://apidocs.apptoto.com/reference/v1participants_auto_messages-1.md
  - https://apidocs.apptoto.com/reference/v1participants_auto_messages.md
  - https://apidocs.apptoto.com/reference/v1participanttag.md
  - https://apidocs.apptoto.com/reference/v1start_conversation.md
  - https://apidocs.apptoto.com/reference/v1userinfo.md
  - https://apidocs.apptoto.com/reference/v1webhooks-1.md
  - https://apidocs.apptoto.com/reference/v1webhooks-2.md
  - https://apidocs.apptoto.com/reference/v1webhooks-3.md
  - https://apidocs.apptoto.com/reference/v1webhooks.md
  merge:
    pages: 43
    deduped: 84
    conflicts_kept_first: 0