The Events API from Mob.ly — 5 operation(s) for events.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/mobly:mobly-events-api"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.
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: 3.2.0
info:
title: Mobly REST Events API
version: v0
description: 'Mobly REST API (version v0).
- JSON-based
- Authenticated via API key
- Versioned under `/v0`'
servers:
- url: https://core-api.getmobly.com/api/v0
security:
- ApiKeyAuth: []
tags:
- name: Events
paths:
/events:
get:
summary: List events
description: List events for the authenticated organization.
security:
- ApiKeyAuth: []
parameters:
- in: query
name: limit
schema:
type: integer
default: 20
maximum: 50
- in: query
name: offset
schema:
type: integer
default: 0
responses:
'200':
description: Events list.
content:
application/json:
schema:
$ref: '#/components/schemas/EventListResponse'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'429':
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
tags:
- Events
operationId: getEvents
x-operation-id-source: derived
post:
summary: Create event
description: Create an event for the authenticated organization.
security:
- ApiKeyAuth: []
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/EventCreateV0Input'
responses:
'200':
description: Created event.
content:
application/json:
schema:
$ref: '#/components/schemas/EventSingleResponse'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
tags:
- Events
operationId: postEvents
x-operation-id-source: derived
/events/{eventId}:
get:
summary: Get event
description: Fetch a single event by ID.
security:
- ApiKeyAuth: []
parameters:
- in: path
name: eventId
schema:
type: integer
required: true
description: Event ID
responses:
'200':
description: Event.
content:
application/json:
schema:
$ref: '#/components/schemas/EventSingleResponse'
'404':
description: Event not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
tags:
- Events
operationId: getEventsByEventId
x-operation-id-source: derived
put:
summary: Update event
description: Update the full event record for the authenticated organization.
security:
- ApiKeyAuth: []
parameters:
- in: path
name: eventId
schema:
type: integer
required: true
description: Event ID
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/EventUpdateV0Input'
responses:
'200':
description: Updated event.
content:
application/json:
schema:
$ref: '#/components/schemas/EventSingleResponse'
'404':
description: Event not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
tags:
- Events
operationId: putEventsByEventId
x-operation-id-source: derived
delete:
summary: Delete event
description: Delete an event for the authenticated organization.
security:
- ApiKeyAuth: []
parameters:
- in: path
name: eventId
schema:
type: integer
required: true
description: Event ID
responses:
'200':
description: Event deleted.
content:
application/json:
schema:
type: object
properties:
status:
type: integer
example: 200
results:
type: object
required:
- status
- results
'404':
description: Event not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
tags:
- Events
operationId: deleteEventsByEventId
x-operation-id-source: derived
/events/{eventId}/leads:
get:
summary: List event leads
description: Retrieve the leads associated with a specific event, including registration and check-in status.
security:
- ApiKeyAuth: []
parameters:
- in: path
name: eventId
schema:
type: integer
required: true
description: Event ID
- in: query
name: limit
schema:
type: integer
default: 20
maximum: 50
- in: query
name: offset
schema:
type: integer
default: 0
responses:
'200':
description: Event leads list.
content:
application/json:
schema:
$ref: '#/components/schemas/EventLeadsListResponse'
tags:
- Events
operationId: getEventsByEventIdLeads
x-operation-id-source: derived
put:
summary: Add or update event leads
description: 'Associate existing leads with an event and optionally update their `registered` and `checkedIn` status.
- Creates association if missing.
- Updates flags if association exists.'
security:
- ApiKeyAuth: []
parameters:
- in: path
name: eventId
schema:
type: integer
required: true
description: Event ID
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/EventAddLeadsV0Input'
responses:
'200':
description: Updated event lead associations.
content:
application/json:
schema:
$ref: '#/components/schemas/EventLeadsUpdateResponse'
tags:
- Events
operationId: putEventsByEventIdLeads
x-operation-id-source: derived
/events/{eventId}/leads/{leadId}:
delete:
summary: Remove lead from event
description: Delete a lead's association with an event for the authenticated organization.
security:
- ApiKeyAuth: []
parameters:
- in: path
name: eventId
schema:
type: integer
required: true
description: Event ID
- in: path
name: leadId
schema:
type: string
required: true
description: Lead ID
responses:
'200':
description: Association removed.
content:
application/json:
schema:
type: object
properties:
status:
type: integer
example: 200
results:
type: object
required:
- status
- results
tags:
- Events
operationId: deleteEventsByEventIdLeadsByLeadId
x-operation-id-source: derived
/events/{eventId}/users:
get:
summary: List event users
description: Retrieve the users assigned to a specific event for the authenticated organization.
security:
- ApiKeyAuth: []
parameters:
- in: path
name: eventId
schema:
type: integer
required: true
description: Event ID
- in: query
name: limit
schema:
type: integer
default: 20
maximum: 50
- in: query
name: offset
schema:
type: integer
default: 0
responses:
'200':
description: Event users list.
content:
application/json:
schema:
$ref: '#/components/schemas/EventUsersListResponse'
tags:
- Events
operationId: getEventsByEventIdUsers
x-operation-id-source: derived
components:
schemas:
EventCreateV0Input:
type: object
properties:
eventName:
type: string
eventType:
$ref: '#/components/schemas/EventType'
startDate:
type: string
format: date
endDate:
type: string
format: date
createdByEmail:
type: string
format: email
registrationEnabled:
type: boolean
required:
- eventName
- eventType
- startDate
- endDate
- createdByEmail
EventSingleResponse:
type: object
properties:
status:
type: integer
example: 200
results:
$ref: '#/components/schemas/Event'
required:
- status
- results
EventUsersListResponse:
type: object
properties:
status:
type: integer
example: 200
pagination:
$ref: '#/components/schemas/Pagination'
results:
type: object
properties:
users:
type: array
items:
$ref: '#/components/schemas/UserV0Response'
total:
type: integer
required:
- status
- pagination
- results
Location:
type: object
properties:
streetAddress:
type:
- string
- 'null'
city:
type:
- string
- 'null'
state:
type:
- string
- 'null'
zip:
type:
- string
- 'null'
country:
type:
- string
- 'null'
latitude:
type:
- string
- 'null'
longitude:
type:
- string
- 'null'
timeZone:
type:
- string
- 'null'
EventListResponse:
type: object
properties:
status:
type: integer
example: 200
pagination:
$ref: '#/components/schemas/Pagination'
results:
type: object
properties:
events:
type: array
items:
$ref: '#/components/schemas/Event'
total:
type: integer
required:
- status
- pagination
- results
EventLeadsListResponse:
type: object
properties:
status:
type: integer
example: 200
pagination:
$ref: '#/components/schemas/Pagination'
results:
type: object
properties:
eventLeads:
type: array
items:
$ref: '#/components/schemas/EventLeadV0Response'
total:
type: integer
required:
- status
- pagination
- results
ErrorResponse:
type: object
properties:
status:
type: integer
error:
type: string
required:
- status
- error
Event:
type: object
properties:
id:
type: integer
format: int64
name:
type: string
type:
$ref: '#/components/schemas/EventType'
registrationEnabled:
type: boolean
createdAt:
type: string
format: date-time
startDate:
type:
- string
- 'null'
format: date
endDate:
type:
- string
- 'null'
format: date
location:
allOf:
- $ref: '#/components/schemas/Location'
tagGroups:
type: array
items:
type: string
format: uuid
required:
- id
- name
- type
- registrationEnabled
- createdAt
- tagGroups
EventLeadV0Response:
type: object
properties:
leadId:
type: string
format: uuid
registered:
type: boolean
checkedIn:
type: boolean
required:
- leadId
- registered
- checkedIn
EventUpdateV0Input:
type: object
properties:
eventName:
type: string
eventType:
$ref: '#/components/schemas/EventType'
startDate:
type: string
format: date
endDate:
type: string
format: date
registrationEnabled:
type: boolean
required:
- eventName
- eventType
- startDate
- endDate
EventAddLeadsV0Input:
type: object
properties:
eventLeads:
type: array
items:
type: object
properties:
leadId:
type: string
format: uuid
registered:
type: boolean
checkedIn:
type: boolean
required:
- leadId
required:
- eventLeads
UserV0Response:
type: object
properties:
id:
type: integer
email:
type:
- string
- 'null'
firstName:
type:
- string
- 'null'
lastName:
type:
- string
- 'null'
required:
- id
- email
- firstName
- lastName
EventLeadsUpdateResponse:
type: object
properties:
status:
type: integer
example: 200
results:
type: object
properties:
eventLeads:
type: array
items:
$ref: '#/components/schemas/EventLeadV0Response'
required:
- status
- results
EventType:
type: string
description: Event type classification.
enum:
- CONFERENCE
- TRADE_SHOW
- EVENT
- SIDECAR
- DINNER_MEAL
- HAPPY_HOUR
- OTHER
Pagination:
type: object
properties:
limit:
type: integer
format: int32
offset:
type: integer
format: int32
required:
- limit
- offset
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key
x-provenance:
method: harvested
publisher: Mob.ly
source: https://openapi.gitbook.com/o/jaPKDvV3e46vsYDXzb4V/spec/mobly-rest-api-v0.yaml
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)