How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

MagicBell project API

The project API from MagicBell — 52 operation(s) for project.

MagicBell project API is one of 28 APIs that MagicBell publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Project. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and authentication docs.

This API exposes 91 operations across 52 paths, and defines 75 schemas. It is described by OpenAPI 3.0.3, at version 2.0.0.

Requests are made against a single base URL, https://api.magicbell.com/v2.

91 operations 52 paths 75 schemas 38 DELETE34 GET3 POST16 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
2.0.0
Base URL
https://api.magicbell.com/v2
Contact
Resource Areas
1

Paths & Operations 91

Across 52 paths, the API surfaces 91 operations — 38 DELETE, 34 GET, 3 POST, 16 PUT. Each is listed below with its method, path, parameters, and response codes.

project 91
GET
/broadcasts
Retrieves a paginated list of broadcasts for the project. Returns basic information about each broadcast including its creation time and status.
list_broadcasts 3 params → 200
POST
/broadcasts
Creates a new broadcast message. When a broadcast is created, it generates individual notifications for relevant users within the project. Only administrators can create broadcasts.
create_broadcast body → 201
GET
/broadcasts/{broadcast_id}
Retrieves detailed information about a specific broadcast by its ID. Includes the broadcast's configuration and current status.
fetch_broadcast 1 param → 200
GET
/channels/deliveryconfig
get_project_deliveryconfig 1 param → 200
PUT
/channels/deliveryconfig
save_project_deliveryconfig body → 200
GET
/events
Retrieves a paginated list of events for the project.
get_events 3 params → 200
GET
/integrations
List Integrations
list_integrations 3 params → 200
DELETE
/integrations/apns
Removes a apns integration configuration from the project. This will disable the integration's functionality within the project.
delete_apns_integration → 204
GET
/integrations/apns
Retrieves the current apns integration configurations for a specific integration type in the project. Returns configuration details and status information.
get_apns_integration → 200
PUT
/integrations/apns
Creates or updates a apns integration for the project. Only administrators can configure integrations.
save_apns_integration body → 200
DELETE
/integrations/apns/{id}
Removes a specific apns integration instance by ID from the project.
delete_apns_integration_by_id 1 param → 204
DELETE
/integrations/awssns
Removes a awssns integration configuration from the project. This will disable the integration's functionality within the project.
delete_awssns_integration → 204
GET
/integrations/awssns
Retrieves the current awssns integration configurations for a specific integration type in the project. Returns configuration details and status information.
get_awssns_integration → 200
PUT
/integrations/awssns
Creates or updates a awssns integration for the project. Only administrators can configure integrations.
save_awssns_integration body → 200
DELETE
/integrations/awssns/{id}
Removes a specific awssns integration instance by ID from the project.
delete_awssns_integration_by_id 1 param → 204
DELETE
/integrations/expo
Removes a expo integration configuration from the project. This will disable the integration's functionality within the project.
delete_expo_integration → 204
GET
/integrations/expo
Retrieves the current expo integration configurations for a specific integration type in the project. Returns configuration details and status information.
get_expo_integration → 200
PUT
/integrations/expo
Creates or updates a expo integration for the project. Only administrators can configure integrations.
save_expo_integration body → 200
DELETE
/integrations/expo/{id}
Removes a specific expo integration instance by ID from the project.
delete_expo_integration_by_id 1 param → 204
DELETE
/integrations/fcm
Removes a fcm integration configuration from the project. This will disable the integration's functionality within the project.
delete_fcm_integration → 204
GET
/integrations/fcm
Retrieves the current fcm integration configurations for a specific integration type in the project. Returns configuration details and status information.
get_fcm_integration → 200
PUT
/integrations/fcm
Creates or updates a fcm integration for the project. Only administrators can configure integrations.
save_fcm_integration body → 200
DELETE
/integrations/fcm/{id}
Removes a specific fcm integration instance by ID from the project.
delete_fcm_integration_by_id 1 param → 204
DELETE
/integrations/github
Removes a github integration configuration from the project. This will disable the integration's functionality within the project.
delete_github_integration → 204
GET
/integrations/github
Retrieves the current github integration configurations for a specific integration type in the project. Returns configuration details and status information.
get_github_integration → 200
PUT
/integrations/github
Creates or updates a github integration for the project. Only administrators can configure integrations.
save_github_integration body → 200
DELETE
/integrations/github/{id}
Removes a specific github integration instance by ID from the project.
delete_github_integration_by_id 1 param → 204
DELETE
/integrations/inbox
Removes a inbox integration configuration from the project. This will disable the integration's functionality within the project.
delete_inbox_integration → 204
GET
/integrations/inbox
Retrieves the current inbox integration configurations for a specific integration type in the project. Returns configuration details and status information.
get_inbox_integration → 200
PUT
/integrations/inbox
Creates or updates a inbox integration for the project. Only administrators can configure integrations.
save_inbox_integration body → 200
DELETE
/integrations/inbox/{id}
Removes a specific inbox integration instance by ID from the project.
delete_inbox_integration_by_id 1 param → 204
DELETE
/integrations/mailgun
Removes a mailgun integration configuration from the project. This will disable the integration's functionality within the project.
delete_mailgun_integration → 204
GET
/integrations/mailgun
Retrieves the current mailgun integration configurations for a specific integration type in the project. Returns configuration details and status information.
get_mailgun_integration → 200
PUT
/integrations/mailgun
Creates or updates a mailgun integration for the project. Only administrators can configure integrations.
save_mailgun_integration body → 200
DELETE
/integrations/mailgun/{id}
Removes a specific mailgun integration instance by ID from the project.
delete_mailgun_integration_by_id 1 param → 204
DELETE
/integrations/ping_email
Removes a pingemail integration configuration from the project. This will disable the integration's functionality within the project.
delete_ping_email_integration → 204
GET
/integrations/ping_email
Retrieves the current pingemail integration configurations for a specific integration type in the project. Returns configuration details and status information.
get_ping_email_integration → 200
PUT
/integrations/ping_email
Creates or updates a pingemail integration for the project. Only administrators can configure integrations.
save_ping_email_integration body → 200
DELETE
/integrations/ping_email/{id}
Removes a specific pingemail integration instance by ID from the project.
delete_ping_email_integration_by_id 1 param → 204
DELETE
/integrations/sendgrid
Removes a sendgrid integration configuration from the project. This will disable the integration's functionality within the project.
delete_sendgrid_integration → 204
GET
/integrations/sendgrid
Retrieves the current sendgrid integration configurations for a specific integration type in the project. Returns configuration details and status information.
get_sendgrid_integration → 200
PUT
/integrations/sendgrid
Creates or updates a sendgrid integration for the project. Only administrators can configure integrations.
save_sendgrid_integration body → 200
DELETE
/integrations/sendgrid/{id}
Removes a specific sendgrid integration instance by ID from the project.
delete_sendgrid_integration_by_id 1 param → 204
DELETE
/integrations/ses
Removes a ses integration configuration from the project. This will disable the integration's functionality within the project.
delete_ses_integration → 204
GET
/integrations/ses
Retrieves the current ses integration configurations for a specific integration type in the project. Returns configuration details and status information.
get_ses_integration → 200
PUT
/integrations/ses
Creates or updates a ses integration for the project. Only administrators can configure integrations.
save_ses_integration body → 200
DELETE
/integrations/ses/{id}
Removes a specific ses integration instance by ID from the project.
delete_ses_integration_by_id 1 param → 204
DELETE
/integrations/slack
Removes a slack integration configuration from the project. This will disable the integration's functionality within the project.
delete_slack_integration → 204
GET
/integrations/slack
Retrieves the current slack integration configurations for a specific integration type in the project. Returns configuration details and status information.
get_slack_integration → 200
PUT
/integrations/slack
Creates or updates a slack integration for the project. Only administrators can configure integrations.
save_slack_integration body → 200
DELETE
/integrations/slack/{id}
Removes a specific slack integration instance by ID from the project.
delete_slack_integration_by_id 1 param → 204
DELETE
/integrations/stripe
Removes a stripe integration configuration from the project. This will disable the integration's functionality within the project.
delete_stripe_integration → 204
GET
/integrations/stripe
Retrieves the current stripe integration configurations for a specific integration type in the project. Returns configuration details and status information.
get_stripe_integration → 200
PUT
/integrations/stripe
Creates or updates a stripe integration for the project. Only administrators can configure integrations.
save_stripe_integration body → 200
DELETE
/integrations/stripe/{id}
Removes a specific stripe integration instance by ID from the project.
delete_stripe_integration_by_id 1 param → 204
DELETE
/integrations/templates
Removes a templates integration configuration from the project. This will disable the integration's functionality within the project.
delete_templates_integration → 204
GET
/integrations/templates
Retrieves the current templates integration configurations for a specific integration type in the project. Returns configuration details and status information.
get_templates_integration → 200
PUT
/integrations/templates
Creates or updates a templates integration for the project. Only administrators can configure integrations.
save_templates_integration body → 200
DELETE
/integrations/templates/{id}
Removes a specific templates integration instance by ID from the project.
delete_templates_integration_by_id 1 param → 204
DELETE
/integrations/twilio
Removes a twilio integration configuration from the project. This will disable the integration's functionality within the project.
delete_twilio_integration → 204
GET
/integrations/twilio
Retrieves the current twilio integration configurations for a specific integration type in the project. Returns configuration details and status information.
get_twilio_integration → 200
PUT
/integrations/twilio
Creates or updates a twilio integration for the project. Only administrators can configure integrations.
save_twilio_integration body → 200
DELETE
/integrations/twilio/{id}
Removes a specific twilio integration instance by ID from the project.
delete_twilio_integration_by_id 1 param → 204
DELETE
/integrations/web_push
Removes a webpush integration configuration from the project. This will disable the integration's functionality within the project.
delete_web_push_integration → 204
GET
/integrations/web_push
Retrieves the current webpush integration configurations for a specific integration type in the project. Returns configuration details and status information.
get_web_push_integration → 200
PUT
/integrations/web_push
Creates or updates a webpush integration for the project. Only administrators can configure integrations.
save_web_push_integration body → 200
DELETE
/integrations/web_push/{id}
Removes a specific webpush integration instance by ID from the project.
delete_web_push_integration_by_id 1 param → 204
GET
/jwt/project
Retrieves a list of all active project-level JWT tokens. Returns a paginated list showing token metadata including creation date, last used date, and expiration time. For security reasons, the actual…
fetch_project_tokens 3 params → 200
POST
/jwt/project
Creates a new project-level JWT token. These tokens provide project-wide access and should be carefully managed. Only administrators can create project tokens. The returned token should be securely s…
create_project_jwt body → 201
DELETE
/jwt/project/{token_id}
Immediately revokes a project-level JWT token. Once revoked, any requests using this token will be rejected. This action is immediate and cannot be undone. Active sessions using this token will be te…
discard_project_jwt 1 param → 200
POST
/jwt/user
Issues a new user-specific JWT token. These tokens are scoped to individual user permissions and access levels. Only administrators can create user tokens. The token is returned only once at creation…
create_user_jwt body → 201
DELETE
/jwt/user/{token_id}
Revokes a specific user's JWT token. This immediately invalidates the token and terminates any active sessions using it. This action cannot be undone. Administrators should use this to revoke access…
discard_user_jwt 1 param → 200
GET
/jwt/user/{user_id}
Lists all JWT tokens associated with a specific user. Returns token metadata including creation time, last access time, and expiration date. Administrators can use this to audit user token usage and…
fetch_user_tokens 4 params → 200
GET
/users/{user_id}/channels/mobile_push/apns/tokens
Lists all mobilepush 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.
get_mobile_push_apns_user_tokens 4 params → 200
DELETE
/users/{user_id}/channels/mobile_push/apns/tokens/{token_id}
Revokes a specific user's mobilepush token. This endpoint is available to project administrators and permanently invalidates the specified token. Once revoked, the token can no longer be used to acce…
discard_mobile_push_apns_user_token 2 params → 200
GET
/users/{user_id}/channels/mobile_push/apns/tokens/{token_id}
Retrieves a specific mobilepush 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 inc…
get_mobile_push_apns_user_token 2 params → 200
GET
/users/{user_id}/channels/mobile_push/expo/tokens
Lists all mobilepush 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.
get_mobile_push_expo_user_tokens 4 params → 200
DELETE
/users/{user_id}/channels/mobile_push/expo/tokens/{token_id}
Revokes a specific user's mobilepush token. This endpoint is available to project administrators and permanently invalidates the specified token. Once revoked, the token can no longer be used to acce…
discard_mobile_push_expo_user_token 2 params → 200
GET
/users/{user_id}/channels/mobile_push/expo/tokens/{token_id}
Retrieves a specific mobilepush 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 inc…
get_mobile_push_expo_user_token 2 params → 200
GET
/users/{user_id}/channels/mobile_push/fcm/tokens
Lists all mobilepush 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.
get_mobile_push_fcm_user_tokens 4 params → 200
DELETE
/users/{user_id}/channels/mobile_push/fcm/tokens/{token_id}
Revokes a specific user's mobilepush token. This endpoint is available to project administrators and permanently invalidates the specified token. Once revoked, the token can no longer be used to acce…
discard_mobile_push_fcm_user_token 2 params → 200
GET
/users/{user_id}/channels/mobile_push/fcm/tokens/{token_id}
Retrieves a specific mobilepush 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 inc…
get_mobile_push_fcm_user_token 2 params → 200
GET
/users/{user_id}/channels/slack/tokens
Lists all slack 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.
get_slack_user_tokens 4 params → 200
DELETE
/users/{user_id}/channels/slack/tokens/{token_id}
Revokes a specific user's slack 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 ch…
discard_slack_user_token 2 params → 200
GET
/users/{user_id}/channels/slack/tokens/{token_id}
Retrieves a specific slack 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 includin…
get_slack_user_token 2 params → 200
GET
/users/{user_id}/channels/teams/tokens
Lists all teams 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.
get_teams_user_tokens 4 params → 200
DELETE
/users/{user_id}/channels/teams/tokens/{token_id}
Revokes a specific user's teams 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 ch…
discard_teams_user_token 2 params → 200
GET
/users/{user_id}/channels/teams/tokens/{token_id}
Retrieves a specific teams 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 includin…
get_teams_user_token 2 params → 200
GET
/users/{user_id}/channels/web_push/tokens
Lists all webpush 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.
get_web_push_user_tokens 4 params → 200
DELETE
/users/{user_id}/channels/web_push/tokens/{token_id}
Revokes a specific user's webpush 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…
discard_web_push_user_token 2 params → 200
GET
/users/{user_id}/channels/web_push/tokens/{token_id}
Retrieves a specific webpush 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 includ…
get_web_push_user_token 2 params → 200

Schemas 75

The contract defines 75 schemas that model the data the API accepts and returns. The most detailed are FCMConfig (11 properties), Broadcast (11 properties), Event (7 properties), APNSTokenResponse (7 properties). Each schema is shown below with its type and property counts.

user
object
IntegrationObject
object
3 properties 3 required
InboxConfig
object
3 properties 3 required
StripeConfig
object
1 property 1 required
CategoryDeliveryConfig
object
3 properties 2 required
ArrayOfTemplatesConfigObjects
object
2 properties
FetchTokensResponseToken
object
5 properties 1 required
ExpoConfig
object
1 property 1 required
PingConfigObject
object
3 properties 3 required
FCMConfigObject
object
3 properties 3 required
AWSSNSConfig
object
1 property 1 required
APNSConfigObject
object
3 properties 3 required
SlackConfigObject
object
3 properties 3 required
ArrayOfTeamsTokenResponses
object
2 properties
ExpoTokenResponse
object
5 properties 3 required
ArrayOfSendgridConfigObjects
object
2 properties
SendgridConfigObject
object
3 properties 3 required
FCMTokenResponse
object
6 properties 3 required
ArrayOfAPNSTokenResponses
object
2 properties
Broadcast
object
11 properties 2 required
ArrayOfTwilioConfigObjects
object
2 properties
ArrayOfInboxConfigObjects
object
2 properties
TemplatesConfigObject
object
3 properties 3 required
topic
object
1 property 1 required
SlackConfig
object
4 properties 4 required
ArrayOfWebPushTokenResponses
object
2 properties
ArrayOfSlackTokenResponses
object
2 properties
Integration
object
PingConfig
object
1 property 1 required
AWSSNSConfigObject
object
3 properties 3 required
ArrayOfSESConfigObjects
object
2 properties
ArrayOfStripeConfigObjects
object
2 properties
ArrayOfMailgunConfigObjects
object
2 properties
DiscardTokenResponse
object
2 properties 2 required
Event
object
7 properties 3 required
SESConfigObject
object
3 properties 3 required
MailgunConfigObject
object
3 properties 3 required
AccessToken
object
4 properties 3 required
WebpushConfig
object
2 properties 2 required
SendgridConfig
object
3 properties 1 required
TeamsTokenResponse
object
5 properties 2 required
ArrayOfBroadcasts
object
2 properties
InboxConfigObject
object
3 properties 3 required
GithubConfigObject
object
3 properties 3 required
APNSConfig
object
6 properties 5 required
MailgunConfig
object
3 properties 3 required
SESConfig
object
4 properties 3 required
FCMConfig
object
11 properties 11 required
ExpoConfigObject
object
3 properties 3 required
ArrayOfFetchTokensResponseTokens
object
2 properties
TemplatesConfig
object
APNSTokenResponse
object
7 properties 3 required
ArrayOfSlackConfigObjects
object
2 properties
DiscardResult
object
2 properties
ArrayOfExpoTokenResponses
object
2 properties
ArrayOfEvents
object
2 properties
ArrayOfGithubConfigObjects
object
2 properties
ArrayOfWebpushConfigObjects
object
2 properties
ArrayOfPingConfigObjects
object
2 properties
ArrayOfIntegrationObjects
object
2 properties
ArrayOfFCMTokenResponses
object
2 properties
TwilioConfigObject
object
3 properties 3 required
ArrayOfAPNSConfigObjects
object
2 properties
ArrayOfExpoConfigObjects
object
2 properties
WebpushConfigObject
object
3 properties 3 required
StripeConfigObject
object
3 properties 3 required
ArrayOfAWSSNSConfigObjects
object
2 properties
TwilioConfig
object
5 properties 4 required
GithubConfig
object
1 property 1 required
Links
object
3 properties
CreateProjectTokenRequest
object
2 properties 1 required
WebPushTokenResponse
object
6 properties 4 required
ArrayOfFCMConfigObjects
object
2 properties
CreateUserTokenRequest
object
4 properties
SlackTokenResponse
object
6 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

magicbell-project-api-openapi.yml Raw ↑

Other APIs MagicBell publishes across the network.

MagicBell REST API v1
MagicBell apns API
MagicBell awssns API
MagicBell broadcasts API
MagicBell channel/email API
MagicBell channel/mobile_push API
MagicBell channel/slack API
MagicBell channel/sms API
MagicBell channel/web_push API
MagicBell channels API
MagicBell expo API
MagicBell fcm API
Where this information came from

This is an independent, third-party profile of MagicBell project API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.