The in_app API from MagicBell — 4 operation(s) for in_app.
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/magicbell:magicbell-in-app-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
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: MagicBell In App API
description: OpenAPI 3.1.0 Specification for MagicBell API.
contact:
name: MagicBell
url: https://wwww.magicbell.com
version: 2.0.0
servers:
- url: https://api.magicbell.com/v2
description: MagicBell API (v2) Base URL
tags:
- name: in_app
paths:
/channels/in_app/inbox/tokens:
summary: Inbox token
description: Scoped APIs for Inbox (`inbox`).
get:
tags:
- in_app
summary: List all Inbox tokens
description: Lists all Inbox tokens belonging to the authenticated user. Returns a paginated list of tokens, including their status, creation dates, and associated metadata.
operationId: list_inbox_tokens
parameters:
- name: limit
in: query
description: 'defines the maximum number of items to return per page (default: 50)'
required: false
schema:
type: integer
- name: starting_after
in: query
description: a cursor for use in pagination, points to the last ID in previous page
required: false
schema:
type: string
- name: ending_before
in: query
description: a cursor for use in pagination, points to the first ID in next page
required: false
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/InboxTokenResponseCollection'
x-magicbell-auth-jwt-type: user
put:
tags:
- in_app
summary: Save an Inbox token
description: Saves the Inbox token for the authenticated user. This token serves as a credential for accessing channel-specific functionality. Each token is unique to the user and channel combination, allowing for direct communication with the user via the channel.
operationId: save_inbox_token
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/InboxToken'
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/InboxToken'
x-magicbell-auth-jwt-type: user
/channels/in_app/inbox/tokens/{token_id}:
summary: Inbox token
description: Scoped APIs for Inbox (`inbox`).
get:
tags:
- in_app
summary: Fetch an Inbox token
description: Fetches details of a specific Inbox token belonging to the authenticated user. Returns information about the token's status, creation date, and any associated metadata. Users can only access their own tokens.
operationId: fetch_inbox_token
parameters:
- name: token_id
in: path
required: true
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/InboxTokenResponse'
x-magicbell-auth-jwt-type: user
delete:
tags:
- in_app
summary: Delete an Inbox token
description: Deletes one of the authenticated user's Inbox tokens. This permanently invalidates the specified token, preventing it from being used for future channel access. This action cannot be undone. Users can only revoke their own tokens.
operationId: delete_inbox_token
parameters:
- name: token_id
in: path
required: true
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/DiscardResult'
x-magicbell-auth-jwt-type: user
/users/{user_id}/channels/in_app/inbox/tokens:
summary: Inbox token
description: Scoped APIs for Inbox (`inbox`).
get:
tags:
- in_app
summary: List an user's Inbox tokens
description: Lists all Inbox tokens associated with a specific user. This endpoint is available to project administrators and returns a paginated list of tokens, including both active and revoked tokens.
operationId: list_user_inbox_tokens
parameters:
- name: user_id
in: path
required: true
schema:
type: string
- name: limit
in: query
description: 'defines the maximum number of items to return per page (default: 50)'
required: false
schema:
type: integer
- name: starting_after
in: query
description: a cursor for use in pagination, points to the last ID in previous page
required: false
schema:
type: string
- name: ending_before
in: query
description: a cursor for use in pagination, points to the first ID in next page
required: false
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/InboxTokenResponseCollection'
x-magicbell-auth-jwt-type: project
/users/{user_id}/channels/in_app/inbox/tokens/{token_id}:
summary: Inbox token
description: Scoped APIs for Inbox (`inbox`).
get:
tags:
- in_app
summary: Fetch a user's Inbox token
description: Fetches a specific Inbox token by its ID for a given user. This endpoint is available to project administrators and requires project-level authentication. Use this to inspect token details including its status, creation date, and associated metadata.
operationId: fetch_user_inbox_token
parameters:
- name: user_id
in: path
required: true
schema:
type: string
- name: token_id
in: path
required: true
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/InboxTokenResponse'
x-magicbell-auth-jwt-type: project
delete:
tags:
- in_app
summary: Delete an user's Inbox token
description: Deletes a specific user's Inbox token. This endpoint is available to project administrators and permanently invalidates the specified token. Once revoked, the token can no longer be used to access channel features. This action cannot be undone.
operationId: delete_user_inbox_token
parameters:
- name: user_id
in: path
required: true
schema:
type: string
- name: token_id
in: path
required: true
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/DiscardResult'
x-magicbell-auth-jwt-type: project
components:
schemas:
InboxTokenResponseCollection:
examples:
- data:
- created_at: '2021-01-01T00:00:00Z'
discarded_at: '2021-01-01T00:00:00Z'
id: '123'
token: eH0fLhuiRj2Np7UQ-opXAm:APA91bGtC-wH4sgW1jWkMKIZf7FYkm_RTQb7Jid7DfSJnCgivGYoRzhLrGxpcIF6yPjmbzAr6CKF-6phZkBasFUUfZmfdgcqfA_ZlZdVk6pSnon3LGzMumCzEJE0zgWoo_RUmVUVJUAt
updated_at: '2021-01-01T00:00:00Z'
links:
first: https://api.magicbell.com/v1/example
next: https://api.magicbell.com/v1/example?page_next=abc
prev: null
properties:
data:
items:
$ref: '#/components/schemas/InboxTokenResponse'
type: array
links:
$ref: '#/components/schemas/Links'
type: object
Links:
properties:
first:
type: string
next:
type:
- string
- 'null'
prev:
type:
- string
- 'null'
type: object
DiscardResult:
examples:
- discarded_at: '2021-01-01T00:00:00Z'
id: '123'
properties:
discarded_at:
description: The timestamp when the token was discarded.
type: string
id:
description: The unique identifier for the discarded token.
type: string
type: object
InboxTokenResponse:
examples:
- created_at: '2021-01-01T00:00:00Z'
discarded_at: '2021-01-01T00:00:00Z'
id: '123'
token: eH0fLhuiRj2Np7UQ-opXAm:APA91bGtC-wH4sgW1jWkMKIZf7FYkm_RTQb7Jid7DfSJnCgivGYoRzhLrGxpcIF6yPjmbzAr6CKF-6phZkBasFUUfZmfdgcqfA_ZlZdVk6pSnon3LGzMumCzEJE0zgWoo_RUmVUVJUAt
updated_at: '2021-01-01T00:00:00Z'
properties:
connection_id:
description: Realtime connection ID to restrict delivery to a specific Ably connection.
type:
- string
- 'null'
created_at:
description: The timestamp when the token was created.
format: date-time
type: string
discarded_at:
description: The timestamp when the token was discarded, if applicable.
format: date-time
type:
- string
- 'null'
id:
description: The unique identifier for the token.
type: string
token:
description: The in-app inbox token generated for this user.
minLength: 64
type: string
updated_at:
description: The timestamp when the token metadata last changed.
format: date-time
type:
- string
- 'null'
required:
- created_at
- id
- token
type: object
InboxToken:
$schema: http://json-schema.org/draft-07/schema#
examples:
- token: eH0fLhuiRj2Np7UQ-opXAm:APA91bGtC-wH4sgW1jWkMKIZf7FYkm_RTQb7Jid7DfSJnCgivGYoRzhLrGxpcIF6yPjmbzAr6CKF-6phZkBasFUUfZmfdgcqfA_ZlZdVk6pSnon3LGzMumCzEJE0zgWoo_RUmVUVJUAt
properties:
connection_id:
description: Realtime connection ID to restrict delivery to a specific Ably connection.
type:
- string
- 'null'
token:
description: The in-app inbox token generated for this user.
minLength: 64
type: string
required:
- token
type: object
x-provenance:
method: harvested
publisher: MagicBell
source: https://www.magicbell.com/docs/api/openapi.json
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)