Business Box Invites API

Single-use booking links

Operations 1

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/marubox-invites-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

marubox-invites-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Business Box Invites API
  version: 1.0.0
  description: Bookings, event types, availability and webhooks for a Business Box account. Authenticate with a personal API key as a bearer token. All times are ISO 8601 UTC; money is an integer in the currency’s minor units, and JPY is zero-decimal, so 5000 is ¥5,000.
  contact:
    name: Business Box support
    email: info@appdevplus.jp
  termsOfService: https://marubox.jp/terms
servers:
- url: https://api.marubox.jp/v1
  description: Production
security:
- bearerAuth: []
tags:
- name: Invites
  description: Single-use booking links
paths:
  /invites:
    post:
      operationId: createInviteLink
      summary: Create a single-use booking link
      tags:
      - Invites
      description: Mints a booking link that works once and then stops. Use it to reply to an enquiry. Works for public and invite-only event types, and the invitee skips the anti-spam checks because the link already proves you meant them. The url is returned only here.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                eventTypeId:
                  type: string
                  pattern: ^[0-9a-f]{24}$
                name:
                  type: string
                  maxLength: 120
                email:
                  type: string
                  maxLength: 254
                  format: email
                  pattern: ^(?:[A-Za-z0-9_'+\-]+\.)*[A-Za-z0-9_'+\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
                expiresInDays:
                  default: 14
                  type: integer
                  minimum: 1
                  maximum: 90
              required:
              - eventTypeId
      responses:
        '201':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                  eventTypeId:
                    type: string
                  url:
                    type:
                    - string
                    - 'null'
                  name:
                    type:
                    - string
                    - 'null'
                  email:
                    type:
                    - string
                    - 'null'
                  expiresAt:
                    type: string
                    format: date-time
                    pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
                  usedAt:
                    anyOf:
                    - type: string
                      format: date-time
                      pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
                    - type: 'null'
                  bookingId:
                    type:
                    - string
                    - 'null'
                  createdAt:
                    type: string
                    format: date-time
                    pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
                required:
                - id
                - eventTypeId
                - url
                - name
                - email
                - expiresAt
                - usedAt
                - bookingId
                - createdAt
                additionalProperties: false
        '400':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        description: 'One of: validation_failed, unauthorized, insufficient_scope, not_found, slot_unavailable, event_type_inactive, booking_state_changed, duplicate_booking, idempotency_conflict, rate_limited, bad_request, internal_error.'
                      message:
                        type: string
                      details: {}
                    required:
                    - code
                    - message
                    additionalProperties: false
                required:
                - error
                additionalProperties: false
        '401':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        description: 'One of: validation_failed, unauthorized, insufficient_scope, not_found, slot_unavailable, event_type_inactive, booking_state_changed, duplicate_booking, idempotency_conflict, rate_limited, bad_request, internal_error.'
                      message:
                        type: string
                      details: {}
                    required:
                    - code
                    - message
                    additionalProperties: false
                required:
                - error
                additionalProperties: false
        '403':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        description: 'One of: validation_failed, unauthorized, insufficient_scope, not_found, slot_unavailable, event_type_inactive, booking_state_changed, duplicate_booking, idempotency_conflict, rate_limited, bad_request, internal_error.'
                      message:
                        type: string
                      details: {}
                    required:
                    - code
                    - message
                    additionalProperties: false
                required:
                - error
                additionalProperties: false
        '404':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        description: 'One of: validation_failed, unauthorized, insufficient_scope, not_found, slot_unavailable, event_type_inactive, booking_state_changed, duplicate_booking, idempotency_conflict, rate_limited, bad_request, internal_error.'
                      message:
                        type: string
                      details: {}
                    required:
                    - code
                    - message
                    additionalProperties: false
                required:
                - error
                additionalProperties: false
        '409':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        description: 'One of: validation_failed, unauthorized, insufficient_scope, not_found, slot_unavailable, event_type_inactive, booking_state_changed, duplicate_booking, idempotency_conflict, rate_limited, bad_request, internal_error.'
                      message:
                        type: string
                      details: {}
                    required:
                    - code
                    - message
                    additionalProperties: false
                required:
                - error
                additionalProperties: false
        '429':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        description: 'One of: validation_failed, unauthorized, insufficient_scope, not_found, slot_unavailable, event_type_inactive, booking_state_changed, duplicate_booking, idempotency_conflict, rate_limited, bad_request, internal_error.'
                      message:
                        type: string
                      details: {}
                    required:
                    - code
                    - message
                    additionalProperties: false
                required:
                - error
                additionalProperties: false
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: A personal API key, created under Settings → Integrations.