Joinways

Joinways Events API

The Events API from Joinways — 23 operation(s) for events.

GitHub OpenAPI

Operations 38

GET /events List events #
POST /events Create an event #
GET /events/{id} Get an event #
PATCH /events/{id} Update an event #
DELETE /events/{id} Delete an archived event #
POST /events/{id}/archive Archive an event #
POST /events/{id}/unarchive Unarchive an event #
POST /events/{id}/status Change an event status #
GET /events/{id}/notes List event notes #
POST /events/{id}/notes Add an event note #
GET /events/{id}/tasks List tasks of an event #
POST /events/{id}/tasks Create a task on an event #
GET /events/{id}/contacts List event day-of contacts #
PUT /events/{id}/contacts Replace event day-of contacts #
GET /events/{id}/days List event days #
PUT /events/{id}/days Update per-day overrides #
GET /events/{id}/slots List event space slots #
POST /events/{id}/slots Create an event space slot #
PATCH /events/{id}/slots/{slotId} Update an event space slot #
DELETE /events/{id}/slots/{slotId} Delete an event space slot #
GET /events/{id}/staff List event staff #
PUT /events/{id}/staff Replace event staff #
GET /events/{id}/vendors List event vendors #
POST /events/{id}/vendors Add a vendor to the event #
PATCH /events/{id}/vendors/{vendorEntryId} Update an event vendor #
DELETE /events/{id}/vendors/{vendorEntryId} Remove a vendor from the event #
GET /events/{id}/emails List emails linked to an event #
POST /events/{id}/emails Send an email about an event #
GET /events/{id}/files List event files #
POST /events/{id}/files Attach an uploaded file #
POST /events/{id}/files/uploads Create a file upload URL #
DELETE /events/{id}/files/{fileId} Delete an event file #
GET /events/{id}/activities List the event history #
GET /event-stages List pipeline stages #
GET /events/{id}/beo Get the BEO of an event #
PUT /events/{id}/beo Update event-level BEO fields #
GET /events/{id}/beo/pdf Download the BEO as PDF #
GET /vendors List the workspace's vendors #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/joinways-app/openapi/joinways-app-events-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/joinways-app/json-schema/joinways-app-event-schema.json
📊
JSONSchema
https://artifacts.apis.io/joinways-app/json-schema/joinways-app-event-summary-schema.json

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/joinways-app:joinways-app-events-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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.

GitHub Google LinkedIn

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

OpenAPI Specification

joinways-app-events-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Joinways Public Events API
  version: 1.15.0
  description: 'The Joinways REST API lets you read and manage your CRM and event data:

    events, quotes, invoices, companies, contacts, leads (requests), venues,

    catalog, tasks, reports and more. It is a **JSON over HTTPS** API described by

    this OpenAPI 3.1 document, served at `https://joinways.app/openapi.yaml`

    and rendered at `https://joinways.app/docs/api`. The same data is reachable from AI assistants through the Joinways MCP

    server (`https://mcp.joinways.app`, guide at

    `https://joinways.app/docs/claude-mcp`): both surfaces share the OAuth

    server, the tokens, the scopes, the role permissions and the services of

    the app, so a rule holds the same way in the app, in the REST API and in

    MCP. ## Authentication


    Every request needs a **Bearer token** in the `Authorization` header:


    ```

    Authorization: Bearer jw_xxxxxxxx

    ```


    Two token types work:


    - **API key** (`jw_…`): an owner or admin creates one from **Settings →

    Developers → API keys** in the workspace (guide:

    `https://joinways.app/docs/api-keys`). An API key acts as the member

    who created it: it carries the read and write scopes, and the **role

    permissions its creator holds now** in the workspace (see below; a

    creator who leaves the workspace takes the key''s access with them). It

    does not expire unless you set an expiry, and can be revoked at any

    time from the same page. - **OAuth 2.1 access token** (`jw_oat_…`): for apps acting on a user''s

    behalf (Authorization Code + PKCE S256, same flow as the MCP server). - Authorization endpoint `https://joinways.app/oauth/authorize`, token

    endpoint `https://joinways.app/api/oauth/token`, revocation

    `https://joinways.app/api/oauth/revoke` (RFC 7009), metadata

    `https://joinways.app/.well-known/oauth-authorization-server`. - **Clients**: register with Dynamic Client Registration

    (`POST /api/oauth/register`), or use an https URL as `client_id`

    (Client ID Metadata Document). - **Resource** (RFC 8707): send `resource=https://joinways.app/api/v1`

    on the authorization and token requests to bind the token to this API

    (a token bound to `https://mcp.joinways.app` is refused here, and the

    other way round). An unknown resource is refused with

    `invalid_target`. Protected resource metadata:

    `https://joinways.app/.well-known/oauth-protected-resource/api/v1`. - **Refresh**: a client registered with the `refresh_token` grant gets a

    refresh token (`jw_ort_…`) next to a **1 hour** access token. Each

    refresh rotates the refresh token (the old one stops working); a

    refresh token unused for 90 days expires. A client without the

    refresh grant gets a **30 day** access token and re-runs the flow. A refresh may ask for fewer scopes: only the new access token is

    narrowed. A user who left the workspace gets `invalid_grant` on

    refresh, and the whole token family is revoked. - **Granted scope** = requested ∩ supported (`mcp.read`, `mcp.write`)

    ∩ registered by the client. - The authorization response carries `iss` (RFC 9207). The consent

    screen shows the host of a metadata-document client, and warns when

    the `redirect_uri` is on another domain. - A workspace owner sees and revokes connected apps in **Settings →

    Developers → MCP → Connected apps**. A token is **bound to a single workspace**. You never pass an

    `account_id`: the workspace comes from the token. The API is part of

    the **Pro plan and the free trial**: a valid token of a workspace

    without either is refused with `403 forbidden`, `details.reason:

    plan_not_eligible`. Revocation takes effect within about a minute

    across our infrastructure. Tokens are stored hashed (SHA-256) and shown

    once. A `401` carries the RFC 6750 / RFC 9728 challenge:


    ```

    WWW-Authenticate: Bearer resource_metadata="https://joinways.app/.well-known/oauth-protected-resource/api/v1", scope="mcp.read mcp.write"

    ```


    ## Scopes


    | Scope | Grants |

    |---|---|

    | `mcp.read` | Every `GET` |

    | `mcp.write` | Every `POST`, `PATCH`, `PUT`, `DELETE`, and reading (it implies `mcp.read`) |


    API keys carry both scopes.'
  contact:
    name: Joinways
    url: https://joinways.app
  license:
    name: Proprietary
  x-logo:
    url: /images/marketing/logo-header.svg
    altText: Joinways
    href: https://joinways.app
servers:
- url: https://joinways.app/api/v1
  description: Production
security:
- bearerAuth: []
- oauth2:
  - mcp.read
  - mcp.write
tags:


# --- truncated at 32 KB (138 KB total) ---
# Full source: https://artifacts.apis.io/joinways-app/openapi/joinways-app-events-api-openapi.yml