Apptoto Participants API

The Participants API from Apptoto — 2 operation(s) for participants.

Operations 6

GET /v1/participants /v1/participants #
POST /v1/participants /v1/participants #
PUT /v1/participants /v1/participants #
DELETE /v1/participants /v1/participants #
GET /v1/participants/{id}/auto_messages /v1/participants/{id}/auto_messages #
PUT /v1/participants/{id}/auto_messages /v1/participants/{id}/auto_messages #

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-participants-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-participants-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: api-settings Participants API
  version: '1.0'
servers:
- url: https://api.apptoto.com
security:
- sec0: []
- sec1: []
tags:
- name: Participants
paths:
  /v1/participants:
    get:
      summary: /v1/participants
      description: List the participants on an event. Deleted participants are excluded.
      operationId: v1participants
      parameters:
      - name: event_id
        in: query
        description: The Apptoto id of the event whose participants you want to list.
        required: true
        schema:
          type: integer
          format: int32
      - name: include_conversations
        in: query
        description: If true, each participant includes a "conversations" array of any messages sent to them.
        schema:
          type: boolean
          default: false
      deprecated: false
      security:
      - sec0: []
      - sec1:
        - events:read
      tags:
      - Participants
    post:
      summary: /v1/participants
      description: Add a participant to an existing event. Supply a contact_id to add an existing contact, or supply at least one of name, phone, or email to create a participant from raw details.
      operationId: v1participants-1
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
              - event_id
              properties:
                event_id:
                  type: integer
                  format: int32
                  description: The Apptoto id of the event to add the participant to.
                contact_id:
                  type: integer
                  format: int32
                  description: The Apptoto id of an existing contact to add as a participant.  When provided, name, phone, and email are optional overrides of the contact's details.
                name:
                  type: string
                  description: The participant's name.  Required unless phone or email is provided.
                phone:
                  type: string
                  description: The participant's phone number.  Required unless name or email is provided.
                email:
                  type: string
                  description: The participant's email address.  Required unless name or phone is provided.
      deprecated: false
      security:
      - sec0: []
      - sec1:
        - events:write
      tags:
      - Participants
    put:
      summary: /v1/participants
      description: Update a single participant's RSVP state.
      operationId: v1participants-2
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
              - id
              properties:
                id:
                  type: integer
                  format: int32
                  description: The Apptoto id of the participant to update.
                state:
                  type: string
                  enum:
                  - confirmed
                  - not_coming
                  - needs_reschedule
                  - initial
                  description: The RSVP state to set.  "confirmed" marks the participant as confirmed, "not_coming" cancels, "needs_reschedule" cancels and flags a reschedule request, and "initial" resets the participant to its un-responded state.
      deprecated: false
      security:
      - sec0: []
      - sec1:
        - events:write
      tags:
      - Participants
    delete:
      summary: /v1/participants
      description: Soft-delete a participant. This removes them from the event in the Apptoto UI and halts any messages being sent to them.
      operationId: v1participants-3
      parameters:
      - name: id
        in: query
        description: The Apptoto id of the participant to delete.
        required: true
        schema:
          type: integer
          format: int32
      deprecated: false
      security:
      - sec0: []
      - sec1:
        - events:write
      tags:
      - Participants
  /v1/participants/{id}/auto_messages:
    get:
      summary: /v1/participants/{id}/auto_messages
      description: List the automated reminder messages from a participant's applicable schedule, evaluated for that participant. Each message reports whether it applies, when it would fire, and whether it is currently queued to send.
      operationId: v1participants_auto_messages
      parameters:
      - name: id
        in: path
        description: The Apptoto id of the participant.
        required: true
        schema:
          type: integer
          format: int32
      deprecated: false
      security:
      - sec0: []
      - sec1:
        - events:read
      tags:
      - Participants
    put:
      summary: /v1/participants/{id}/auto_messages
      description: Queue or un-queue a single automated message for a participant. Set queued=true to schedule the message to send automatically at its configured time, or queued=false to cancel a scheduled message.
      operationId: v1participants_auto_messages-1
      parameters:
      - name: id
        in: path
        description: The Apptoto id of the participant.
        required: true
        schema:
          type: integer
          format: int32
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
              - message_id
              - queued
              properties:
                message_id:
                  type: integer
                  format: int32
                  description: The id of the auto message (from the list endpoint) to queue or un-queue.
                queued:
                  type: boolean
                  description: true to schedule the message for its configured time; false to cancel a scheduled message.
      deprecated: false
      security:
      - sec0: []
      - sec1:
        - events:write
      tags:
      - Participants
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