openapi: 3.0.3 info: title: MagicBell apns project API description: OpenAPI 3.0.3 Specification for MagicBell API. contact: name: MagicBell url: https://magicbell.com email: hello@magicbell.com version: 2.0.0 servers: - url: https://api.magicbell.com/v2 description: MagicBell REST API Base URL tags: - name: project paths: /broadcasts: get: tags: - project description: Retrieves a paginated list of broadcasts for the project. Returns basic information about each broadcast including its creation time and status. operationId: list_broadcasts parameters: - name: page[size] in: query required: false schema: type: integer - name: page[after] in: query required: false schema: type: string - name: page[before] in: query required: false schema: type: string responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ArrayOfBroadcasts' post: tags: - project description: 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. operationId: create_broadcast requestBody: content: application/json: schema: $ref: '#/components/schemas/Broadcast' responses: '201': description: Created content: application/json: schema: $ref: '#/components/schemas/Broadcast' /broadcasts/{broadcast_id}: get: tags: - project description: Retrieves detailed information about a specific broadcast by its ID. Includes the broadcast's configuration and current status. operationId: fetch_broadcast parameters: - name: broadcast_id in: path required: true schema: type: string responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/Broadcast' /channels/deliveryconfig: get: tags: - project description: '' operationId: get_project_deliveryconfig parameters: - name: key in: query required: false schema: type: string responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/CategoryDeliveryConfig' put: tags: - project description: '' operationId: save_project_deliveryconfig requestBody: content: application/json: schema: $ref: '#/components/schemas/CategoryDeliveryConfig' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/CategoryDeliveryConfig' /events: get: tags: - project description: Retrieves a paginated list of events for the project. operationId: get_events parameters: - name: page[size] in: query required: false schema: type: integer - name: page[after] in: query required: false schema: type: string - name: page[before] in: query required: false schema: type: string responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ArrayOfEvents' /integrations: get: tags: - project summary: List Integrations description: Lists all available and configured integrations for the project. Returns a summary of each integration including its type, status, and basic configuration information. operationId: list_integrations parameters: - name: page[size] in: query required: false schema: type: integer - name: page[after] in: query required: false schema: type: string - name: page[before] in: query required: false schema: type: string responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ArrayOfIntegrationObjects' /integrations/apns: delete: tags: - project description: Removes a apns integration configuration from the project. This will disable the integration's functionality within the project. operationId: delete_apns_integration responses: '204': description: No Content x-meta: channel: mobile_push displayName: APNs name: apns get: tags: - project description: Retrieves the current apns integration configurations for a specific integration type in the project. Returns configuration details and status information. operationId: get_apns_integration responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ArrayOfAPNSConfigObjects' put: tags: - project description: Creates or updates a apns integration for the project. Only administrators can configure integrations. operationId: save_apns_integration requestBody: content: application/json: schema: $ref: '#/components/schemas/APNSConfig' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/APNSConfig' x-meta: channel: mobile_push displayName: APNs name: apns /integrations/apns/{id}: delete: tags: - project description: Removes a specific apns integration instance by ID from the project. operationId: delete_apns_integration_by_id parameters: - name: id in: path required: true schema: type: string responses: '204': description: No Content x-meta: channel: mobile_push displayName: APNs name: apns /integrations/awssns: delete: tags: - project description: Removes a awssns integration configuration from the project. This will disable the integration's functionality within the project. operationId: delete_awssns_integration responses: '204': description: No Content x-meta: displayName: Amazon SNS name: awssns get: tags: - project description: Retrieves the current awssns integration configurations for a specific integration type in the project. Returns configuration details and status information. operationId: get_awssns_integration responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ArrayOfAWSSNSConfigObjects' put: tags: - project description: Creates or updates a awssns integration for the project. Only administrators can configure integrations. operationId: save_awssns_integration requestBody: content: application/json: schema: $ref: '#/components/schemas/AWSSNSConfig' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AWSSNSConfig' x-forbid-unknown-cookie: true x-forbid-unknown-header: true x-forbid-unknown-path: true x-forbid-unknown-query: true x-meta: displayName: Amazon SNS name: awssns /integrations/awssns/{id}: delete: tags: - project description: Removes a specific awssns integration instance by ID from the project. operationId: delete_awssns_integration_by_id parameters: - name: id in: path required: true schema: type: string responses: '204': description: No Content x-meta: displayName: Amazon SNS name: awssns /integrations/expo: delete: tags: - project description: Removes a expo integration configuration from the project. This will disable the integration's functionality within the project. operationId: delete_expo_integration responses: '204': description: No Content x-meta: channel: mobile_push displayName: Expo name: expo get: tags: - project description: Retrieves the current expo integration configurations for a specific integration type in the project. Returns configuration details and status information. operationId: get_expo_integration responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ArrayOfExpoConfigObjects' put: tags: - project description: Creates or updates a expo integration for the project. Only administrators can configure integrations. operationId: save_expo_integration requestBody: content: application/json: schema: $ref: '#/components/schemas/ExpoConfig' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ExpoConfig' x-meta: channel: mobile_push displayName: Expo name: expo /integrations/expo/{id}: delete: tags: - project description: Removes a specific expo integration instance by ID from the project. operationId: delete_expo_integration_by_id parameters: - name: id in: path required: true schema: type: string responses: '204': description: No Content x-meta: channel: mobile_push displayName: Expo name: expo /integrations/fcm: delete: tags: - project description: Removes a fcm integration configuration from the project. This will disable the integration's functionality within the project. operationId: delete_fcm_integration responses: '204': description: No Content x-meta: channel: mobile_push displayName: FCM name: fcm get: tags: - project description: Retrieves the current fcm integration configurations for a specific integration type in the project. Returns configuration details and status information. operationId: get_fcm_integration responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ArrayOfFCMConfigObjects' put: tags: - project description: Creates or updates a fcm integration for the project. Only administrators can configure integrations. operationId: save_fcm_integration requestBody: content: application/json: schema: $ref: '#/components/schemas/FCMConfig' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/FCMConfig' x-meta: channel: mobile_push displayName: FCM name: fcm /integrations/fcm/{id}: delete: tags: - project description: Removes a specific fcm integration instance by ID from the project. operationId: delete_fcm_integration_by_id parameters: - name: id in: path required: true schema: type: string responses: '204': description: No Content x-meta: channel: mobile_push displayName: FCM name: fcm /integrations/github: delete: tags: - project description: Removes a github integration configuration from the project. This will disable the integration's functionality within the project. operationId: delete_github_integration responses: '204': description: No Content x-meta: displayName: GitHub name: github get: tags: - project description: Retrieves the current github integration configurations for a specific integration type in the project. Returns configuration details and status information. operationId: get_github_integration responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ArrayOfGithubConfigObjects' put: tags: - project description: Creates or updates a github integration for the project. Only administrators can configure integrations. operationId: save_github_integration requestBody: content: application/json: schema: $ref: '#/components/schemas/GithubConfig' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/GithubConfig' x-forbid-unknown-cookie: true x-forbid-unknown-header: true x-forbid-unknown-path: true x-forbid-unknown-query: true x-meta: displayName: GitHub name: github /integrations/github/{id}: delete: tags: - project description: Removes a specific github integration instance by ID from the project. operationId: delete_github_integration_by_id parameters: - name: id in: path required: true schema: type: string responses: '204': description: No Content x-meta: displayName: GitHub name: github /integrations/inbox: delete: tags: - project description: Removes a inbox integration configuration from the project. This will disable the integration's functionality within the project. operationId: delete_inbox_integration responses: '204': description: No Content x-meta: displayName: Inbox name: inbox get: tags: - project description: Retrieves the current inbox integration configurations for a specific integration type in the project. Returns configuration details and status information. operationId: get_inbox_integration responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ArrayOfInboxConfigObjects' put: tags: - project description: Creates or updates a inbox integration for the project. Only administrators can configure integrations. operationId: save_inbox_integration requestBody: content: application/json: schema: $ref: '#/components/schemas/InboxConfig' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/InboxConfig' x-meta: displayName: Inbox name: inbox /integrations/inbox/{id}: delete: tags: - project description: Removes a specific inbox integration instance by ID from the project. operationId: delete_inbox_integration_by_id parameters: - name: id in: path required: true schema: type: string responses: '204': description: No Content x-meta: displayName: Inbox name: inbox /integrations/mailgun: delete: tags: - project description: Removes a mailgun integration configuration from the project. This will disable the integration's functionality within the project. operationId: delete_mailgun_integration responses: '204': description: No Content x-meta: channel: email displayName: Mailgun name: mailgun get: tags: - project description: Retrieves the current mailgun integration configurations for a specific integration type in the project. Returns configuration details and status information. operationId: get_mailgun_integration responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ArrayOfMailgunConfigObjects' put: tags: - project description: Creates or updates a mailgun integration for the project. Only administrators can configure integrations. operationId: save_mailgun_integration requestBody: content: application/json: schema: $ref: '#/components/schemas/MailgunConfig' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MailgunConfig' x-meta: channel: email displayName: Mailgun name: mailgun /integrations/mailgun/{id}: delete: tags: - project description: Removes a specific mailgun integration instance by ID from the project. operationId: delete_mailgun_integration_by_id parameters: - name: id in: path required: true schema: type: string responses: '204': description: No Content x-meta: channel: email displayName: Mailgun name: mailgun /integrations/ping_email: delete: tags: - project description: Removes a ping_email integration configuration from the project. This will disable the integration's functionality within the project. operationId: delete_ping_email_integration responses: '204': description: No Content x-meta: channel: email displayName: Ping Email name: ping_email get: tags: - project description: Retrieves the current ping_email integration configurations for a specific integration type in the project. Returns configuration details and status information. operationId: get_ping_email_integration responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ArrayOfPingConfigObjects' put: tags: - project description: Creates or updates a ping_email integration for the project. Only administrators can configure integrations. operationId: save_ping_email_integration requestBody: content: application/json: schema: $ref: '#/components/schemas/PingConfig' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/PingConfig' x-meta: channel: email displayName: Ping Email name: ping_email /integrations/ping_email/{id}: delete: tags: - project description: Removes a specific ping_email integration instance by ID from the project. operationId: delete_ping_email_integration_by_id parameters: - name: id in: path required: true schema: type: string responses: '204': description: No Content x-meta: channel: email displayName: Ping Email name: ping_email /integrations/sendgrid: delete: tags: - project description: Removes a sendgrid integration configuration from the project. This will disable the integration's functionality within the project. operationId: delete_sendgrid_integration responses: '204': description: No Content x-meta: channel: email displayName: SendGrid name: sendgrid get: tags: - project description: Retrieves the current sendgrid integration configurations for a specific integration type in the project. Returns configuration details and status information. operationId: get_sendgrid_integration responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ArrayOfSendgridConfigObjects' put: tags: - project description: Creates or updates a sendgrid integration for the project. Only administrators can configure integrations. operationId: save_sendgrid_integration requestBody: content: application/json: schema: $ref: '#/components/schemas/SendgridConfig' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/SendgridConfig' x-meta: channel: email displayName: SendGrid name: sendgrid /integrations/sendgrid/{id}: delete: tags: - project description: Removes a specific sendgrid integration instance by ID from the project. operationId: delete_sendgrid_integration_by_id parameters: - name: id in: path required: true schema: type: string responses: '204': description: No Content x-meta: channel: email displayName: SendGrid name: sendgrid /integrations/ses: delete: tags: - project description: Removes a ses integration configuration from the project. This will disable the integration's functionality within the project. operationId: delete_ses_integration responses: '204': description: No Content x-meta: channel: email displayName: Amazon SES name: ses get: tags: - project description: Retrieves the current ses integration configurations for a specific integration type in the project. Returns configuration details and status information. operationId: get_ses_integration responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ArrayOfSESConfigObjects' put: tags: - project description: Creates or updates a ses integration for the project. Only administrators can configure integrations. operationId: save_ses_integration requestBody: content: application/json: schema: $ref: '#/components/schemas/SESConfig' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/SESConfig' x-meta: channel: email displayName: Amazon SES name: ses /integrations/ses/{id}: delete: tags: - project description: Removes a specific ses integration instance by ID from the project. operationId: delete_ses_integration_by_id parameters: - name: id in: path required: true schema: type: string responses: '204': description: No Content x-meta: channel: email displayName: Amazon SES name: ses /integrations/slack: delete: tags: - project description: Removes a slack integration configuration from the project. This will disable the integration's functionality within the project. operationId: delete_slack_integration responses: '204': description: No Content x-meta: channel: slack displayName: Slack name: slack get: tags: - project description: Retrieves the current slack integration configurations for a specific integration type in the project. Returns configuration details and status information. operationId: get_slack_integration responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ArrayOfSlackConfigObjects' put: tags: - project description: Creates or updates a slack integration for the project. Only administrators can configure integrations. operationId: save_slack_integration requestBody: content: application/json: schema: $ref: '#/components/schemas/SlackConfig' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/SlackConfig' x-meta: channel: slack displayName: Slack name: slack /integrations/slack/{id}: delete: tags: - project description: Removes a specific slack integration instance by ID from the project. operationId: delete_slack_integration_by_id parameters: - name: id in: path required: true schema: type: string responses: '204': description: No Content x-meta: channel: slack displayName: Slack name: slack /integrations/stripe: delete: tags: - project description: Removes a stripe integration configuration from the project. This will disable the integration's functionality within the project. operationId: delete_stripe_integration responses: '204': description: No Content x-meta: displayName: Stripe name: stripe get: tags: - project description: Retrieves the current stripe integration configurations for a specific integration type in the project. Returns configuration details and status information. operationId: get_stripe_integration responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ArrayOfStripeConfigObjects' put: tags: - project description: Creates or updates a stripe integration for the project. Only administrators can configure integrations. operationId: save_stripe_integration requestBody: content: application/json: schema: $ref: '#/components/schemas/StripeConfig' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/StripeConfig' x-forbid-unknown-cookie: true x-forbid-unknown-header: true x-forbid-unknown-path: true x-forbid-unknown-query: true x-meta: displayName: Stripe name: stripe /integrations/stripe/{id}: delete: tags: - project description: Removes a specific stripe integration instance by ID from the project. operationId: delete_stripe_integration_by_id parameters: - name: id in: path required: true schema: type: string responses: '204': description: No Content x-meta: displayName: Stripe name: stripe /integrations/templates: delete: tags: - project description: Removes a templates integration configuration from the project. This will disable the integration's functionality within the project. operationId: delete_templates_integration responses: '204': description: No Content x-meta: displayName: Templates name: templates get: tags: - project description: Retrieves the current templates integration configurations for a specific integration type in the project. Returns configuration details and status information. operationId: get_templates_integration responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ArrayOfTemplatesConfigObjects' put: tags: - project description: Creates or updates a templates integration for the project. Only administrators can configure integrations. operationId: save_templates_integration requestBody: content: application/json: schema: $ref: '#/components/schemas/TemplatesConfig' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TemplatesConfig' x-meta: displayName: Templates name: templates /integrations/templates/{id}: delete: tags: - project description: Removes a specific templates integration instance by ID from the project. operationId: delete_templates_integration_by_id parameters: - name: id in: path required: true schema: type: string responses: '204': description: No Content x-meta: displayName: Templates name: templates /integrations/twilio: delete: tags: - project description: Removes a twilio integration configuration from the project. This will disable the integration's functionality within the project. operationId: delete_twilio_integration responses: '204': description: No Content x-meta: channel: sms displayName: Twilio name: twilio get: tags: - project description: Retrieves the current twilio integration configurations for a specific integration type in the project. Returns configuration details and status information. operationId: get_twilio_integration responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ArrayOfTwilioConfigObjects' put: tags: - project description: Creates or updates a twilio integration for the project. Only administrators can configure integrations. operationId: save_twilio_integration requestBody: content: application/json: schema: $ref: '#/components/schemas/TwilioConfig' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TwilioConfig' x-meta: channel: sms displayName: Twilio name: twilio /integrations/twilio/{id}: delete: tags: - project description: Removes a specific twilio integration instance by ID from the project. operationId: delete_twilio_integration_by_id parameters: - name: id in: path required: true schema: type: string responses: '204': description: No Content x-meta: channel: sms displayName: Twilio name: twilio /integrations/web_push: delete: tags: - project description: Removes a web_push integration configuration from the project. This will disable the integration's functionality within the project. operationId: delete_web_push_integration responses: '204': description: No Content x-meta: channel: web_push displayName: Web Push name: web_push get: tags: - project description: Retrieves the current web_push integration configurations for a specific integration type in the project. Returns configuration details and status information. operationId: get_web_push_integration responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ArrayOfWebpushConfigObjects' put: tags: - project description: Creates or updates a web_push integration for the project. Only administrators can configure integrations. operationId: save_web_push_integration requestBody: content: application/json: schema: $ref: '#/components/schemas/WebpushConfig' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/WebpushConfig' x-meta: channel: web_push displayName: Web Push name: web_push /integrations/web_push/{id}: delete: tags: - project description: Removes a specific web_push integration instance by ID from the project. operationId: delete_web_push_integration_by_id parameters: - name: id in: path required: true schema: type: string responses: '204': description: No Content x-meta: channel: web_push displayName: Web Push name: web_push /jwt/project: get: tags: - project description: 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 token values are not included in the response. operationId: fetch_project_tokens parameters: - name: page[size] in: query required: false schema: type: integer - name: page[after] in: query required: false schema: type: string - name: page[before] in: query required: false schema: type: string responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ArrayOfFetchTokensResponseTokens' post: tags: - project description: 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 stored as it cannot be retrieved again after creation. operationId: create_project_jwt requestBody: content: application/json: schema: $ref: '#/components/schemas/CreateProjectTokenRequest' responses: '201': description: Created content: application/json: schema: $ref: '#/components/schemas/AccessToken' /jwt/project/{token_id}: delete: tags: - project description: 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 terminated. operationId: discard_project_jwt parameters: - name: token_id in: path required: true schema: type: string responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/DiscardTokenResponse' /jwt/user: post: tags: - project description: 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 time and cannot be retrieved later. operationId: create_user_jwt requestBody: content: application/json: schema: $ref: '#/components/schemas/CreateUserTokenRequest' responses: '201': description: Created content: application/json: schema: $ref: '#/components/schemas/AccessToken' /jwt/user/{token_id}: delete: tags: - project description: 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 when needed for security purposes. operationId: discard_user_jwt parameters: - name: token_id in: path required: true schema: type: string responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/DiscardTokenResponse' /jwt/user/{user_id}: get: tags: - project description: 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 manage active sessions. Token values are not included in the response for security reasons. operationId: fetch_user_tokens parameters: - name: user_id in: path required: true schema: type: string - name: page[size] in: query required: false schema: type: integer - name: page[after] in: query required: false schema: type: string - name: page[before] in: query required: false schema: type: string responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ArrayOfFetchTokensResponseTokens' /users/{user_id}/channels/mobile_push/apns/tokens: get: tags: - project description: Lists all mobile_push 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: get_mobile_push_apns_user_tokens parameters: - name: user_id in: path required: true schema: type: string - name: page[size] in: query required: false schema: type: integer - name: page[after] in: query required: false schema: type: string - name: page[before] in: query required: false schema: type: string responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ArrayOfAPNSTokenResponses' /users/{user_id}/channels/mobile_push/apns/tokens/{token_id}: delete: tags: - project description: Revokes a specific user's mobile_push 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: discard_mobile_push_apns_user_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' get: tags: - project description: Retrieves a specific mobile_push 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: get_mobile_push_apns_user_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/APNSTokenResponse' /users/{user_id}/channels/mobile_push/expo/tokens: get: tags: - project description: Lists all mobile_push 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: get_mobile_push_expo_user_tokens parameters: - name: user_id in: path required: true schema: type: string - name: page[size] in: query required: false schema: type: integer - name: page[after] in: query required: false schema: type: string - name: page[before] in: query required: false schema: type: string responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ArrayOfExpoTokenResponses' /users/{user_id}/channels/mobile_push/expo/tokens/{token_id}: delete: tags: - project description: Revokes a specific user's mobile_push 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: discard_mobile_push_expo_user_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' get: tags: - project description: Retrieves a specific mobile_push 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: get_mobile_push_expo_user_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/ExpoTokenResponse' /users/{user_id}/channels/mobile_push/fcm/tokens: get: tags: - project description: Lists all mobile_push 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: get_mobile_push_fcm_user_tokens parameters: - name: user_id in: path required: true schema: type: string - name: page[size] in: query required: false schema: type: integer - name: page[after] in: query required: false schema: type: string - name: page[before] in: query required: false schema: type: string responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ArrayOfFCMTokenResponses' /users/{user_id}/channels/mobile_push/fcm/tokens/{token_id}: delete: tags: - project description: Revokes a specific user's mobile_push 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: discard_mobile_push_fcm_user_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' get: tags: - project description: Retrieves a specific mobile_push 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: get_mobile_push_fcm_user_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/FCMTokenResponse' /users/{user_id}/channels/slack/tokens: get: tags: - project description: 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. operationId: get_slack_user_tokens parameters: - name: user_id in: path required: true schema: type: string - name: page[size] in: query required: false schema: type: integer - name: page[after] in: query required: false schema: type: string - name: page[before] in: query required: false schema: type: string responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ArrayOfSlackTokenResponses' /users/{user_id}/channels/slack/tokens/{token_id}: delete: tags: - project description: 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 channel features. This action cannot be undone. operationId: discard_slack_user_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' get: tags: - project description: 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 including its status, creation date, and associated metadata. operationId: get_slack_user_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/SlackTokenResponse' /users/{user_id}/channels/teams/tokens: get: tags: - project description: 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. operationId: get_teams_user_tokens parameters: - name: user_id in: path required: true schema: type: string - name: page[size] in: query required: false schema: type: integer - name: page[after] in: query required: false schema: type: string - name: page[before] in: query required: false schema: type: string responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ArrayOfTeamsTokenResponses' /users/{user_id}/channels/teams/tokens/{token_id}: delete: tags: - project description: 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 channel features. This action cannot be undone. operationId: discard_teams_user_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' get: tags: - project description: 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 including its status, creation date, and associated metadata. operationId: get_teams_user_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/TeamsTokenResponse' /users/{user_id}/channels/web_push/tokens: get: tags: - project description: Lists all web_push 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: get_web_push_user_tokens parameters: - name: user_id in: path required: true schema: type: string - name: page[size] in: query required: false schema: type: integer - name: page[after] in: query required: false schema: type: string - name: page[before] in: query required: false schema: type: string responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ArrayOfWebPushTokenResponses' /users/{user_id}/channels/web_push/tokens/{token_id}: delete: tags: - project description: Revokes a specific user's web_push 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: discard_web_push_user_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' get: tags: - project description: Retrieves a specific web_push 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: get_web_push_user_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/WebPushTokenResponse' components: schemas: user: type: object allOf: - anyOf: - required: - email type: object properties: email: type: string format: email external_id: pattern: \s* type: string - required: - email type: object properties: email: type: string format: email external_id: pattern: ^[^\s]+ type: string - required: - external_id type: object properties: email: type: string format: email external_id: pattern: ^[^\s]+ type: string - required: - external_id type: object properties: email: type: string format: \s+ external_id: minLength: 1 pattern: ^[^\s]+ type: string - minProperties: 1 type: object properties: custom_attributes: type: object email: maxLength: 255 type: string external_id: maxLength: 255 type: string first_name: maxLength: 255 type: string last_name: maxLength: 255 type: string phone_numbers: type: array items: pattern: ^\+\d{1,3}\s?\d{1,14}$ type: string additionalProperties: false IntegrationObject: required: - name - id - config type: object properties: config: $ref: '#/components/schemas/Integration' id: type: string name: type: string InboxConfig: required: - theme - locale - images type: object properties: images: minProperties: 1 required: - emptyInboxUrl type: object properties: emptyInboxUrl: type: string nullable: true locale: minLength: 2 type: string nullable: true theme: minProperties: 1 type: object properties: banner: required: - fontSize - backgroundColor - textColor type: object properties: backgroundColor: type: string backgroundOpacity: type: number fontSize: type: string textColor: type: string dialog: required: - backgroundColor - textColor - accentColor type: object properties: accentColor: type: string backgroundColor: type: string textColor: type: string footer: required: - fontSize - backgroundColor - textColor - borderRadius type: object properties: backgroundColor: type: string borderRadius: type: string fontSize: type: string textColor: type: string header: required: - fontFamily - fontSize - backgroundColor - textColor - borderRadius type: object properties: backgroundColor: type: string borderRadius: type: string fontFamily: type: string fontSize: type: string textColor: type: string icon: required: - borderColor - width type: object properties: borderColor: type: string width: type: string notification: required: - default - unseen - unread type: object properties: default: required: - fontFamily - fontSize - textColor - borderRadius - backgroundColor - margin type: object properties: backgroundColor: type: string borderRadius: type: string fontFamily: type: string fontSize: type: string hover: required: - backgroundColor type: object properties: backgroundColor: type: string margin: type: string state: required: - color type: object properties: color: type: string textColor: type: string unread: required: - textColor - backgroundColor type: object properties: backgroundColor: type: string hover: required: - backgroundColor type: object properties: backgroundColor: type: string state: required: - color type: object properties: color: type: string textColor: type: string unseen: required: - textColor - backgroundColor type: object properties: backgroundColor: type: string hover: required: - backgroundColor type: object properties: backgroundColor: type: string state: required: - color type: object properties: color: type: string textColor: type: string unseenBadge: required: - backgroundColor type: object properties: backgroundColor: type: string nullable: true example: images: emptyInboxUrl: '' locale: de theme: banner: backgroundColor: '#F8F5FF' fontSize: 14px textColor: '#3A424D' dialog: accentColor: '#5225C1' backgroundColor: '#F5F5F5' textColor: '#313131' footer: backgroundColor: '#FFFFFF' borderRadius: 16px fontFamily: inherit fontSize: 15px textColor: '#5225C1' header: backgroundColor: '#FFFFFF' borderRadius: 16px fontFamily: inherit fontSize: 15px textColor: '#5225C1' icon: borderColor: '#EDEDEF' width: 24px unseenBadge: backgroundColor: '#F80808' StripeConfig: required: - webhook_signing_secret type: object properties: webhook_signing_secret: maxLength: 100 minLength: 1 type: string description: The signing secret to verify incoming requests from Stripe additionalProperties: false example: webhook_signing_secret: whsec_e5cf4458caae49ae72d8f275deb9b63bdd41dd5c932c27c9346d428fb9e1d0a0 CategoryDeliveryConfig: required: - channels - key type: object properties: channels: type: array items: required: - channel type: object properties: channel: enum: - in_app - slack - web_push - mobile_push - teams - email type: string delay: minimum: 0 type: integer disabled: type: boolean default: false if: type: string priority: minimum: 0 type: integer disabled: type: boolean default: false key: minLength: 3 pattern: ^[A-Za-z0-9_\.\-:]+$ type: string example: channels: - channel: in_app - channel: email if: '{{notification.unseen}} == false' disabled: false key: project ArrayOfTemplatesConfigObjects: type: object properties: data: type: array items: $ref: '#/components/schemas/TemplatesConfigObject' links: $ref: '#/components/schemas/Links' example: data: - config: apns: app_id: com.example.myapp badge: unread certificate: MIICXQIBAAKBgQC3J2 key_id: ABCD1234EF team_id: ABCD1234EF id: '123' name: slack links: first: https://api.magicbell.com/v1/example next: https://api.magicbell.com/v1/example?page[next]=abc prev: null FetchTokensResponseToken: required: - created_at type: object properties: created_at: type: string format: date-time discarded_at: type: string format: date-time expires_at: type: string format: date-time id: type: string format: uuid name: type: string ExpoConfig: required: - access_token type: object properties: access_token: minLength: 1 type: string example: access_token: expo_access_token PingConfigObject: required: - name - id - config type: object properties: config: $ref: '#/components/schemas/PingConfig' id: type: string name: type: string FCMConfigObject: required: - name - id - config type: object properties: config: $ref: '#/components/schemas/FCMConfig' id: type: string name: type: string AWSSNSConfig: required: - webhook_signing_secret type: object properties: webhook_signing_secret: minLength: 1 type: string description: The signing certificate from AWS SNS additionalProperties: false example: webhook_signing_secret: whsec_e5cf4458caae49ae72d8f275deb9b63bdd41dd5c932c27c9346d428fb9e1d0a0 APNSConfigObject: required: - name - id - config type: object properties: config: $ref: '#/components/schemas/APNSConfig' id: type: string name: type: string SlackConfigObject: required: - name - id - config type: object properties: config: $ref: '#/components/schemas/SlackConfig' id: type: string name: type: string ArrayOfTeamsTokenResponses: type: object properties: data: type: array items: $ref: '#/components/schemas/TeamsTokenResponse' links: $ref: '#/components/schemas/Links' example: data: - created_at: '2021-01-01T00:00:00Z' discarded_at: '2021-01-01T00:00:00Z' id: '123' 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 ExpoTokenResponse: required: - created_at - device_token - id type: object properties: created_at: type: string format: date-time device_token: minLength: 1 type: string discarded_at: type: string format: date-time nullable: true id: type: string updated_at: type: string format: date-time nullable: true example: created_at: '2021-01-01T00:00:00Z' device_token: expo-device-id discarded_at: '2021-01-01T00:00:00Z' id: '123' updated_at: '2021-01-01T00:00:00Z' ArrayOfSendgridConfigObjects: type: object properties: data: type: array items: $ref: '#/components/schemas/SendgridConfigObject' links: $ref: '#/components/schemas/Links' example: data: - config: api_key: SG.1234567890 from: email: matt@magicbell.com name: Matt reply_to: email: hana@magicbell.com name: Hana id: '123' name: slack links: first: https://api.magicbell.com/v1/example next: https://api.magicbell.com/v1/example?page[next]=abc prev: null SendgridConfigObject: required: - name - id - config type: object properties: config: $ref: '#/components/schemas/SendgridConfig' id: type: string name: type: string FCMTokenResponse: required: - created_at - device_token - id type: object properties: created_at: type: string format: date-time device_token: minLength: 64 type: string discarded_at: type: string format: date-time nullable: true id: type: string installation_id: enum: - development - production type: string updated_at: type: string format: date-time nullable: true example: created_at: '2021-01-01T00:00:00Z' device_token: eH0fLhuiRj2Np7UQ-opXAm:APA91bGtC-wH4sgW1jWkMKIZf7FYkm_RTQb7Jid7DfSJnCgivGYoRzhLrGxpcIF6yPjmbzAr6CKF-6phZkBasFUUfZmfdgcqfA_ZlZdVk6pSnon3LGzMumCzEJE0zgWoo_RUmVUVJUAt discarded_at: '2021-01-01T00:00:00Z' id: '123' installation_id: development updated_at: '2021-01-01T00:00:00Z' ArrayOfAPNSTokenResponses: type: object properties: data: type: array items: $ref: '#/components/schemas/APNSTokenResponse' links: $ref: '#/components/schemas/Links' example: data: - created_at: '2021-01-01T00:00:00Z' device_token: eH0fLhuiRj2Np7UQ-opXAm:APA91bGtC-wH4sgW1jWkMKIZf7FYkm_RTQb7Jid7DfSJnCgivGYoRzhLrGxpcIF6yPjmbzAr6CKF-6phZkBasFUUfZmfdgcqfA_ZlZdVk6pSnon3LGzMumCzEJE0zgWoo_RUmVUVJUAt discarded_at: '2021-01-01T00:00:00Z' id: '123' installation_id: development 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 Broadcast: required: - title - recipients type: object properties: action_url: maxLength: 2048 type: string nullable: true category: maxLength: 255 pattern: ^[A-Za-z0-9_\.\-/:]+$ type: string nullable: true content: maxLength: 10485760 type: string nullable: true created_at: type: string description: The timestamp when the broadcast was created. format: date-time readOnly: true custom_attributes: type: object nullable: true id: type: string description: The unique id for this broadcast. overrides: type: object properties: channels: type: object properties: email: type: object properties: action_url: maxLength: 2048 type: string nullable: true content: maxLength: 1048576 type: string title: maxLength: 255 minLength: 1 type: string in_app: type: object properties: action_url: maxLength: 2048 type: string nullable: true content: maxLength: 1048576 type: string title: maxLength: 255 minLength: 1 type: string mobile_push: type: object properties: action_url: maxLength: 2048 type: string nullable: true content: maxLength: 1048576 type: string title: maxLength: 255 minLength: 1 type: string slack: type: object properties: action_url: maxLength: 2048 type: string nullable: true content: maxLength: 1048576 type: string title: maxLength: 255 minLength: 1 type: string sms: type: object properties: action_url: maxLength: 2048 type: string nullable: true content: maxLength: 1048576 type: string title: maxLength: 255 minLength: 1 type: string web_push: type: object properties: action_url: maxLength: 2048 type: string nullable: true content: maxLength: 1048576 type: string title: maxLength: 255 minLength: 1 type: string providers: type: object properties: amazon_ses: type: object android: type: object ios: type: object mailgun: type: object postmark: type: object sendgrid: type: object slack: type: object additionalProperties: false nullable: true recipients: maxItems: 1000 minItems: 1 type: array items: type: object oneOf: - $ref: '#/components/schemas/topic' - $ref: '#/components/schemas/user' status: required: - status - summary - errors type: object properties: errors: type: array items: type: object properties: message: type: string nullable: true status: enum: - enqueued - processing - processed type: string readOnly: true summary: required: - total - failures type: object properties: failures: type: integer description: The number of failures while processing the broadcast. readOnly: true total: type: integer description: The number of recipients that the broadcast was sent to. readOnly: true title: maxLength: 255 minLength: 1 type: string topic: maxLength: 255 pattern: ^[A-Za-z0-9_\.\-/:]+$ type: string nullable: true example: action_url: https://example.com category: example content: Hello, World! custom_attributes: {} id: d1b3b3b3-3b3b-3b3b-3b3b-3b3b3b3b3b3b overrides: {} recipients: - custom_attributes: plan: enterprise preferred_pronoun: They pricing_version: v10 email: test@example.com external_id: 83d987a-83fd034 first_name: Person last_name: Doe phone_numbers: - +1 5005550001 title: Hello, World! topic: example ArrayOfTwilioConfigObjects: type: object properties: data: type: array items: $ref: '#/components/schemas/TwilioConfigObject' links: $ref: '#/components/schemas/Links' example: data: - config: account_sid: ACXXXXXXXX api_key: SKXXXXXXXX api_secret: your_api_secret from: '+15017122661' region: us1 id: '123' name: slack links: first: https://api.magicbell.com/v1/example next: https://api.magicbell.com/v1/example?page[next]=abc prev: null ArrayOfInboxConfigObjects: type: object properties: data: type: array items: $ref: '#/components/schemas/InboxConfigObject' links: $ref: '#/components/schemas/Links' example: data: - config: images: emptyInboxUrl: '' locale: de theme: banner: backgroundColor: '#F8F5FF' fontSize: 14px textColor: '#3A424D' dialog: accentColor: '#5225C1' backgroundColor: '#F5F5F5' textColor: '#313131' footer: backgroundColor: '#FFFFFF' borderRadius: 16px fontFamily: inherit fontSize: 15px textColor: '#5225C1' header: backgroundColor: '#FFFFFF' borderRadius: 16px fontFamily: inherit fontSize: 15px textColor: '#5225C1' icon: borderColor: '#EDEDEF' width: 24px unseenBadge: backgroundColor: '#F80808' id: '123' name: slack links: first: https://api.magicbell.com/v1/example next: https://api.magicbell.com/v1/example?page[next]=abc prev: null TemplatesConfigObject: required: - name - id - config type: object properties: config: $ref: '#/components/schemas/TemplatesConfig' id: type: string name: type: string topic: required: - topic type: object properties: topic: required: - subscribers type: object properties: subscribers: type: boolean additionalProperties: false additionalProperties: false SlackConfig: required: - app_id - client_id - client_secret - signing_secret type: object properties: app_id: pattern: ^[0-9A-Z]+$ type: string description: The Slack app ID that can be found in the app's settings page of the Slack API dashboard. client_id: pattern: ^[0-9]+\.[0-9]+$ type: string description: The Slack client ID that can be found in the app's settings page of the Slack API dashboard. client_secret: maxLength: 32 minLength: 32 type: string description: The Slack client secret that can be found in the app's settings page of the Slack API dashboard. signing_secret: maxLength: 32 minLength: 32 type: string description: The Slack signing secret that can be found in the app's settings page of the Slack API dashboard. example: app_id: '12345678901' client_id: '1.0' client_secret: '12345678901234567890123456789012' signing_secret: '12345678901234567890123456789012' ArrayOfWebPushTokenResponses: type: object properties: data: type: array items: $ref: '#/components/schemas/WebPushTokenResponse' links: $ref: '#/components/schemas/Links' example: data: - created_at: '2021-01-01T00:00:00Z' discarded_at: '2021-01-01T00:00:00Z' endpoint: https://example.com/webhook id: '123' keys: auth: p256dh: 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 ArrayOfSlackTokenResponses: type: object properties: data: type: array items: $ref: '#/components/schemas/SlackTokenResponse' links: $ref: '#/components/schemas/Links' example: data: - created_at: '2021-01-01T00:00:00Z' discarded_at: '2021-01-01T00:00:00Z' id: '123' updated_at: '2021-01-01T00:00:00Z' webhook: url: https://example.com/webhook links: first: https://api.magicbell.com/v1/example next: https://api.magicbell.com/v1/example?page[next]=abc prev: null Integration: type: object PingConfig: required: - url type: object properties: url: maxLength: 100 minLength: 1 type: string description: URL to ping format: uri example: url: https://example.com/webhook AWSSNSConfigObject: required: - name - id - config type: object properties: config: $ref: '#/components/schemas/AWSSNSConfig' id: type: string name: type: string ArrayOfSESConfigObjects: type: object properties: data: type: array items: $ref: '#/components/schemas/SESConfigObject' links: $ref: '#/components/schemas/Links' example: data: - config: from: email: person@example.com name: Person Name key_id: MY_FAKE_AWS_ACCESS_KEY_ID region: eu-west-1 secret_key: MY_FAKE_AWS_SECRET_KEY id: '123' name: slack links: first: https://api.magicbell.com/v1/example next: https://api.magicbell.com/v1/example?page[next]=abc prev: null ArrayOfStripeConfigObjects: type: object properties: data: type: array items: $ref: '#/components/schemas/StripeConfigObject' links: $ref: '#/components/schemas/Links' example: data: - config: webhook_signing_secret: whsec_e5cf4458caae49ae72d8f275deb9b63bdd41dd5c932c27c9346d428fb9e1d0a0 id: '123' name: slack links: first: https://api.magicbell.com/v1/example next: https://api.magicbell.com/v1/example?page[next]=abc prev: null ArrayOfMailgunConfigObjects: type: object properties: data: type: array items: $ref: '#/components/schemas/MailgunConfigObject' links: $ref: '#/components/schemas/Links' example: data: - config: api_key: mailgun_api_key domain: mailgun_domain region: us id: '123' name: slack links: first: https://api.magicbell.com/v1/example next: https://api.magicbell.com/v1/example?page[next]=abc prev: null DiscardTokenResponse: required: - token_id - discarded_at type: object properties: discarded_at: type: string format: date-time token_id: type: string format: uuid example: discarded_at: '2021-01-01T00:00:00Z' token_id: 550e8400-e29b-41d4-a716-446655440000 Event: required: - id - type - timestamp type: object properties: code: type: integer context: type: object nullable: true id: type: string level: type: string log: type: string nullable: true timestamp: type: string format: date-time type: type: string SESConfigObject: required: - name - id - config type: object properties: config: $ref: '#/components/schemas/SESConfig' id: type: string name: type: string MailgunConfigObject: required: - name - id - config type: object properties: config: $ref: '#/components/schemas/MailgunConfig' id: type: string name: type: string AccessToken: required: - token - token_id - created_at type: object properties: created_at: type: string format: date-time expires_at: type: string format: date-time token: type: string token_id: type: string format: uuid example: created_at: '2021-01-01T00:00:00Z' token: eY....... token_id: 019b1b1e-7b1b-4b1b-8b1b-1b1b1b1b1b1b WebpushConfig: required: - public_key - private_key type: object properties: private_key: maxLength: 128 minLength: 8 type: string public_key: maxLength: 128 minLength: 8 type: string example: private_key: public_key: SendgridConfig: required: - api_key type: object properties: api_key: type: string description: The API key for Sendgrid from: required: - email type: object properties: email: type: string description: The email address to send from format: email name: type: string description: The name to send from nullable: true reply_to: required: - email type: object properties: email: type: string description: The email address to reply to format: email name: type: string description: The name to reply to nullable: true example: api_key: SG.1234567890 from: email: matt@magicbell.com name: Matt reply_to: email: hana@magicbell.com name: Hana TeamsTokenResponse: required: - created_at - id type: object properties: created_at: type: string format: date-time discarded_at: type: string format: date-time nullable: true id: type: string updated_at: type: string format: date-time nullable: true webhook: type: object properties: url: type: string example: created_at: '2021-01-01T00:00:00Z' discarded_at: '2021-01-01T00:00:00Z' id: '123' updated_at: '2021-01-01T00:00:00Z' ArrayOfBroadcasts: type: object properties: data: type: array items: $ref: '#/components/schemas/Broadcast' links: $ref: '#/components/schemas/Links' example: data: - action_url: https://example.com category: example content: Hello, World! custom_attributes: {} id: d1b3b3b3-3b3b-3b3b-3b3b-3b3b3b3b3b3b overrides: {} recipients: - custom_attributes: plan: enterprise preferred_pronoun: They pricing_version: v10 email: test@example.com external_id: 83d987a-83fd034 first_name: Person last_name: Doe phone_numbers: - +1 5005550001 title: Hello, World! topic: example links: first: https://api.magicbell.com/v1/example next: https://api.magicbell.com/v1/example?page[next]=abc prev: null InboxConfigObject: required: - name - id - config type: object properties: config: $ref: '#/components/schemas/InboxConfig' id: type: string name: type: string GithubConfigObject: required: - name - id - config type: object properties: config: $ref: '#/components/schemas/GithubConfig' id: type: string name: type: string APNSConfig: required: - app_id - certificate - key_id - team_id - badge type: object properties: app_id: pattern: ^[a-zA-Z0-9]+(.[a-zA-Z0-9]+)*$ type: string description: The default bundle identifier of the application that is configured with this project. It can be overriden on a per token basis, when registering device tokens. badge: enum: - unread - unseen type: string certificate: pattern: ^-+?\s?BEGIN PRIVATE KEY-+\n([A-Za-z0-9+/\r\n]+={0,2})\n-+\s?END PRIVATE KEY+-+\n?$ type: string description: The APNs certificate in P8 format. Generate it at [developer.apple.com](https://developer.apple.com/account/resources/authkeys/add) with the 'Apple Push Notification service (APNs)' option selected. x-ui: tagName: textarea key_id: maxLength: 10 minLength: 10 type: string payload_version: enum: - '1' - '2' type: string default: '2' x-ui: type: hidden team_id: maxLength: 10 minLength: 10 type: string example: app_id: com.example.myapp badge: unread certificate: '-----BEGIN PRIVATE KEY----- MIGTAgEAMBMGByqGSM49AgEGCCqGSM49AwEHBHkwdwIBAQQgHnr4B2P+by++FGu/th0a44E8chJl5v5Vo4gq0YHw6e6gCgYIKoZIzj0DAQehRANCAARCg1MRibnfyeX5mx6+Rtfzzn7UhJP/oaqL4RzSmDuTsd3BTX33cuQ0gWHe20R2m1bLAkI1wrp+zbWOlAOAD7KX -----END PRIVATE KEY-----' key_id: ABCD1234EF team_id: ABCD1234EF MailgunConfig: required: - api_key - region - domain type: object properties: api_key: minLength: 1 type: string domain: minLength: 1 type: string region: enum: - us - eu type: string example: api_key: mailgun_api_key domain: mailgun_domain region: us SESConfig: required: - key_id - secret_key - region type: object properties: from: required: - email type: object properties: email: type: string description: The email address to send from format: email name: type: string description: The name to send from nullable: true key_id: minLength: 1 type: string description: AWS Access Key ID region: minLength: 1 type: string description: AWS Region secret_key: minLength: 1 type: string description: AWS Secret Key example: from: email: person@example.com name: Person Name key_id: MY_FAKE_AWS_ACCESS_KEY_ID region: eu-west-1 secret_key: MY_FAKE_AWS_SECRET_KEY FCMConfig: required: - type - project_id - private_key_id - private_key - client_email - client_id - auth_uri - token_uri - auth_provider_x509_cert_url - client_x509_cert_url - universe_domain type: object properties: auth_provider_x509_cert_url: type: string auth_uri: type: string client_email: type: string client_id: type: string client_x509_cert_url: type: string private_key: pattern: ^-+?\s?BEGIN[A-Z ]+-+\n([A-Za-z0-9+/\r\n]+={0,2})\n-+\s?END[A-Z ]+-+\n?$ type: string x-ui: tagName: textarea private_key_id: type: string project_id: type: string token_uri: type: string type: enum: - service_account type: string universe_domain: type: string example: auth_provider_x509_cert_url: https://www.googleapis.com/oauth2/v1/certs auth_uri: https://accounts.google.com/o/oauth2/auth client_email: firebase-adminsdk-qwhtp@platform-development.iam.gserviceaccount.com client_id: '117893100789081023083' client_x509_cert_url: https://www.googleapis.com/robot/v1/metadata/x509/firebase-adminsdk-qwhtp%40magicbell-development.iam.gserviceaccount.com private_key: '-----BEGIN PRIVATE KEY----- MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQC7/GBHM4AK4/8c ZyvJfdzjBzfA48tV9T3N4hBCb4E66jIz+oztH9oSngEfIVO/L1dWjK1OlN0cqJ0f QaKq1eycSjmwfTR3HGNjQQyoGQ4BFBdyqT5rRDDZLPI2LoR0dtQXcBtiFpJF2t8e iDmpl3d/ipuKMtBRzjYPqzP0qv3YkPmw2v5FqKK9EIaHRtOhd2R28F5FE+kF1dvB t7fEeVtKcQJcSwDUQ8HEshlWSx6azGd4jxf9jHRXWumXYfTA6NMA7EUTDJVus3vU y9MCv2KwZO/dzlQygY0BM9FHPSzZRIiHUx+DH6gYl2uWJatluHz58lj3r5mo/Ssc yP3TrqOnAgMBAAECggEAWAnDe0UCt9b8QGyPBK/V1VspgMQOE+UlOzkenUaEUreg qFg0TM8ofaSS6OXeR0DgGdALUCyGeyf6YcuG55QFWlKmvuF8QzY/05mA2G7XcKjc rF3Xtju61tLmYnqZnMOT46AkquTgPyfYa3+n5aVimRAsdOYESvOUvPTUgcbc2GGK C2h2MUCoRKuhzbGx847XJmINRE+xaht4hDMhzhMBVrgGGyQ3sIdbCxpbiQR6QH2H pITrSnd4hlKRPREWS/D4FUKP/ucXdORP9SUi0R64NRZ3GvT1HvpVZ9fOXwIACdAG 9fpIQbsmIgxhgZ5ZjuGz/nFi2KQ2Y8rEycQmnHd4QQKBgQD4LVFL93E4qwr7Eruj FjyxGYYi2PhVxvrpiSD6ziK3HUjAxat6OcoElJx7WEFWHmi7KRgehqcl40A8Coav 9DGBwnSM2AYKgzOqMqzjK71TFOQsJdGEYThnhiL2FoQeptgskVS7J9MMBPTnyl7D YObINwGbg9auVp66rj5W+dymZwKBgQDB6VdpxJpU9hXBW+8nJESduhzpYiHoe1kN yka90dQDOe2b/R7bnF1Ggte6Ll1dMs3xLhN1Mm2XTcX2zmzM15C0E4+1t1LXXzAo O2P+riEmCIUc1i0yNMVgEKXiOBBYgKauE3fT88c4dw2JAT0QlifJ0h8kRPNhUaq9 espjleNQwQKBgHUzwZ7knn2qmSb1M9PTHppseWJfoPexXrGHZyHK064ykDcpos+4 FuWO4U+G4GQxPDiXMaLI6IsGBUHVnsHdyruC/9O7+S5hw7Zu9CLcdy6TQSZwPcAM wbxyJnSdMYvgM1roz2ELb6nPdXE5qwMN8i8/euzcmDgBBDkZLKuamE+lAoGBAKb7 vd7DAvPvBkUAWi2mub/pqUQA0ZpVvhZ1/f0wWBZ/J/KQQqZzPI+f1Q3rJ1M+kMIE H5Vo257TxooGsQKlD2NDBRpCx//XZK0Al9eVM86Av8BZX4pAj0dujqsEBG9yOhbl hObsor4pJ2q3ulIyPAk7/L1K8xr3LMUGnIqtZJcBAoGAEQffqGbnaOG8Ue3++bLP N6XlAyt5UajAd1CycIHgDvbW0CkWoI70Bg7QNqMYJe6DareH4vRpdB3tw6zNP7qN 0Bd04L8+zUYN+VqNJ70d7Xn+k2rY7STlgU3vwOzHFwu4wK2A7e+aAZ8AjC+Sr0ZM ps+wuWO8MN5yQTBZvAEIfQs= -----END PRIVATE KEY----- ' private_key_id: 1935e74178f6ef0bbc23fb3538255f8281093bf2 project_id: platform-development token_uri: https://oauth2.googleapis.com/token type: service_account universe_domain: googleapis.com ExpoConfigObject: required: - name - id - config type: object properties: config: $ref: '#/components/schemas/ExpoConfig' id: type: string name: type: string ArrayOfFetchTokensResponseTokens: type: object properties: data: type: array items: $ref: '#/components/schemas/FetchTokensResponseToken' links: $ref: '#/components/schemas/Links' example: data: - created_at: '2021-01-01T00:00:00Z' discarded_at: '2021-01-01T00:00:00Z' expires_at: '2021-01-01T00:00:00Z' id: 00000000-0000-0000-0000-000000000000 name: My Token links: first: https://api.magicbell.com/v1/example next: https://api.magicbell.com/v1/example?page[next]=abc prev: null TemplatesConfig: type: object example: apns: app_id: com.example.myapp badge: unread certificate: MIICXQIBAAKBgQC3J2 key_id: ABCD1234EF team_id: ABCD1234EF x-ui: type: hidden APNSTokenResponse: required: - created_at - device_token - id type: object properties: app_id: pattern: ^[a-zA-Z0-9]+(.[a-zA-Z0-9]+)*$ type: string description: (Optional) The bundle identifier of the application that is registering this token. Use this field to override the default identifier specified in the projects APNs integration. created_at: type: string format: date-time device_token: minLength: 64 type: string discarded_at: type: string format: date-time nullable: true id: type: string installation_id: enum: - development - production type: string description: (Optional) The APNs environment the token is registered for. If none is provided we assume the token is used in `production`. updated_at: type: string format: date-time nullable: true example: created_at: '2021-01-01T00:00:00Z' device_token: eH0fLhuiRj2Np7UQ-opXAm:APA91bGtC-wH4sgW1jWkMKIZf7FYkm_RTQb7Jid7DfSJnCgivGYoRzhLrGxpcIF6yPjmbzAr6CKF-6phZkBasFUUfZmfdgcqfA_ZlZdVk6pSnon3LGzMumCzEJE0zgWoo_RUmVUVJUAt discarded_at: '2021-01-01T00:00:00Z' id: '123' installation_id: development updated_at: '2021-01-01T00:00:00Z' ArrayOfSlackConfigObjects: type: object properties: data: type: array items: $ref: '#/components/schemas/SlackConfigObject' links: $ref: '#/components/schemas/Links' example: data: - config: app_id: '12345678901' client_id: '1.0' client_secret: '12345678901234567890123456789012' signing_secret: '12345678901234567890123456789012' id: '123' name: slack links: first: https://api.magicbell.com/v1/example next: https://api.magicbell.com/v1/example?page[next]=abc prev: null DiscardResult: type: object properties: discarded_at: type: string id: type: string example: discarded_at: '2021-01-01T00:00:00Z' id: '123' ArrayOfExpoTokenResponses: type: object properties: data: type: array items: $ref: '#/components/schemas/ExpoTokenResponse' links: $ref: '#/components/schemas/Links' example: data: - created_at: '2021-01-01T00:00:00Z' device_token: expo-device-id discarded_at: '2021-01-01T00:00:00Z' id: '123' 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 ArrayOfEvents: type: object properties: data: type: array items: $ref: '#/components/schemas/Event' links: $ref: '#/components/schemas/Links' example: data: - id: '123' timestamp: '2021-01-01T00:00:00Z' type: example_type links: first: https://api.magicbell.com/v1/example next: https://api.magicbell.com/v1/example?page[next]=abc prev: null ArrayOfGithubConfigObjects: type: object properties: data: type: array items: $ref: '#/components/schemas/GithubConfigObject' links: $ref: '#/components/schemas/Links' example: data: - config: webhook_signing_secret: whsec_e5cf4458caae49ae72d8f275deb9b63bdd41dd5c932c27c9346d428fb9e1d0a0 id: '123' name: slack links: first: https://api.magicbell.com/v1/example next: https://api.magicbell.com/v1/example?page[next]=abc prev: null ArrayOfWebpushConfigObjects: type: object properties: data: type: array items: $ref: '#/components/schemas/WebpushConfigObject' links: $ref: '#/components/schemas/Links' example: data: - config: private_key: public_key: id: '123' name: slack links: first: https://api.magicbell.com/v1/example next: https://api.magicbell.com/v1/example?page[next]=abc prev: null ArrayOfPingConfigObjects: type: object properties: data: type: array items: $ref: '#/components/schemas/PingConfigObject' links: $ref: '#/components/schemas/Links' example: data: - config: url: https://example.com/webhook id: '123' name: slack links: first: https://api.magicbell.com/v1/example next: https://api.magicbell.com/v1/example?page[next]=abc prev: null ArrayOfIntegrationObjects: type: object properties: data: type: array items: $ref: '#/components/schemas/IntegrationObject' links: $ref: '#/components/schemas/Links' example: data: - config: webhook_url: https://example.com/webhook id: '123' name: slack links: first: https://api.magicbell.com/v1/example next: https://api.magicbell.com/v1/example?page[next]=abc prev: null ArrayOfFCMTokenResponses: type: object properties: data: type: array items: $ref: '#/components/schemas/FCMTokenResponse' links: $ref: '#/components/schemas/Links' example: data: - created_at: '2021-01-01T00:00:00Z' device_token: eH0fLhuiRj2Np7UQ-opXAm:APA91bGtC-wH4sgW1jWkMKIZf7FYkm_RTQb7Jid7DfSJnCgivGYoRzhLrGxpcIF6yPjmbzAr6CKF-6phZkBasFUUfZmfdgcqfA_ZlZdVk6pSnon3LGzMumCzEJE0zgWoo_RUmVUVJUAt discarded_at: '2021-01-01T00:00:00Z' id: '123' installation_id: development 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 TwilioConfigObject: required: - name - id - config type: object properties: config: $ref: '#/components/schemas/TwilioConfig' id: type: string name: type: string ArrayOfAPNSConfigObjects: type: object properties: data: type: array items: $ref: '#/components/schemas/APNSConfigObject' links: $ref: '#/components/schemas/Links' example: data: - config: app_id: com.example.myapp badge: unread certificate: '-----BEGIN PRIVATE KEY----- MIGTAgEAMBMGByqGSM49AgEGCCqGSM49AwEHBHkwdwIBAQQgHnr4B2P+by++FGu/th0a44E8chJl5v5Vo4gq0YHw6e6gCgYIKoZIzj0DAQehRANCAARCg1MRibnfyeX5mx6+Rtfzzn7UhJP/oaqL4RzSmDuTsd3BTX33cuQ0gWHe20R2m1bLAkI1wrp+zbWOlAOAD7KX -----END PRIVATE KEY-----' key_id: ABCD1234EF team_id: ABCD1234EF id: '123' name: slack links: first: https://api.magicbell.com/v1/example next: https://api.magicbell.com/v1/example?page[next]=abc prev: null ArrayOfExpoConfigObjects: type: object properties: data: type: array items: $ref: '#/components/schemas/ExpoConfigObject' links: $ref: '#/components/schemas/Links' example: data: - config: access_token: expo_access_token id: '123' name: slack links: first: https://api.magicbell.com/v1/example next: https://api.magicbell.com/v1/example?page[next]=abc prev: null WebpushConfigObject: required: - name - id - config type: object properties: config: $ref: '#/components/schemas/WebpushConfig' id: type: string name: type: string StripeConfigObject: required: - name - id - config type: object properties: config: $ref: '#/components/schemas/StripeConfig' id: type: string name: type: string ArrayOfAWSSNSConfigObjects: type: object properties: data: type: array items: $ref: '#/components/schemas/AWSSNSConfigObject' links: $ref: '#/components/schemas/Links' example: data: - config: webhook_signing_secret: whsec_e5cf4458caae49ae72d8f275deb9b63bdd41dd5c932c27c9346d428fb9e1d0a0 id: '123' name: slack links: first: https://api.magicbell.com/v1/example next: https://api.magicbell.com/v1/example?page[next]=abc prev: null TwilioConfig: required: - account_sid - api_key - api_secret - from type: object properties: account_sid: maxLength: 100 minLength: 1 type: string description: The SID for your Twilio account api_key: maxLength: 100 minLength: 1 type: string description: The API key for Twilio api_secret: maxLength: 100 minLength: 1 type: string description: The API Secret for Twilio from: maxLength: 100 minLength: 1 pattern: ^\+[0-9]{1,14}$ type: string description: The phone number to send from, in E.164 format region: enum: - us1 - ie1 - au1 type: string description: The region to use for Twilio, defaults to 'us1' example: account_sid: ACXXXXXXXX api_key: SKXXXXXXXX api_secret: your_api_secret from: '+15017122661' region: us1 GithubConfig: required: - webhook_signing_secret type: object properties: webhook_signing_secret: maxLength: 100 minLength: 1 type: string description: The signing secret to verify incoming requests from Github additionalProperties: false example: webhook_signing_secret: whsec_e5cf4458caae49ae72d8f275deb9b63bdd41dd5c932c27c9346d428fb9e1d0a0 Links: type: object properties: first: type: string next: type: string nullable: true prev: type: string nullable: true CreateProjectTokenRequest: required: - name type: object properties: expiry: minimum: 1 type: integer description: The duration for which the token is valid (in seconds) name: maxLength: 255 type: string description: The name of the token. example: expiry: 3600 name: My project token WebPushTokenResponse: required: - created_at - endpoint - id - keys type: object properties: created_at: type: string format: date-time discarded_at: type: string format: date-time nullable: true endpoint: type: string format: uri id: type: string keys: required: - p256dh - auth type: object properties: auth: type: string p256dh: type: string updated_at: type: string format: date-time nullable: true example: created_at: '2021-01-01T00:00:00Z' discarded_at: '2021-01-01T00:00:00Z' endpoint: https://example.com/webhook id: '123' keys: auth: p256dh: updated_at: '2021-01-01T00:00:00Z' ArrayOfFCMConfigObjects: type: object properties: data: type: array items: $ref: '#/components/schemas/FCMConfigObject' links: $ref: '#/components/schemas/Links' example: data: - config: auth_provider_x509_cert_url: https://www.googleapis.com/oauth2/v1/certs auth_uri: https://accounts.google.com/o/oauth2/auth client_email: firebase-adminsdk-qwhtp@platform-development.iam.gserviceaccount.com client_id: '117893100789081023083' client_x509_cert_url: https://www.googleapis.com/robot/v1/metadata/x509/firebase-adminsdk-qwhtp%40magicbell-development.iam.gserviceaccount.com private_key: '-----BEGIN PRIVATE KEY----- MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQC7/GBHM4AK4/8c ZyvJfdzjBzfA48tV9T3N4hBCb4E66jIz+oztH9oSngEfIVO/L1dWjK1OlN0cqJ0f QaKq1eycSjmwfTR3HGNjQQyoGQ4BFBdyqT5rRDDZLPI2LoR0dtQXcBtiFpJF2t8e iDmpl3d/ipuKMtBRzjYPqzP0qv3YkPmw2v5FqKK9EIaHRtOhd2R28F5FE+kF1dvB t7fEeVtKcQJcSwDUQ8HEshlWSx6azGd4jxf9jHRXWumXYfTA6NMA7EUTDJVus3vU y9MCv2KwZO/dzlQygY0BM9FHPSzZRIiHUx+DH6gYl2uWJatluHz58lj3r5mo/Ssc yP3TrqOnAgMBAAECggEAWAnDe0UCt9b8QGyPBK/V1VspgMQOE+UlOzkenUaEUreg qFg0TM8ofaSS6OXeR0DgGdALUCyGeyf6YcuG55QFWlKmvuF8QzY/05mA2G7XcKjc rF3Xtju61tLmYnqZnMOT46AkquTgPyfYa3+n5aVimRAsdOYESvOUvPTUgcbc2GGK C2h2MUCoRKuhzbGx847XJmINRE+xaht4hDMhzhMBVrgGGyQ3sIdbCxpbiQR6QH2H pITrSnd4hlKRPREWS/D4FUKP/ucXdORP9SUi0R64NRZ3GvT1HvpVZ9fOXwIACdAG 9fpIQbsmIgxhgZ5ZjuGz/nFi2KQ2Y8rEycQmnHd4QQKBgQD4LVFL93E4qwr7Eruj FjyxGYYi2PhVxvrpiSD6ziK3HUjAxat6OcoElJx7WEFWHmi7KRgehqcl40A8Coav 9DGBwnSM2AYKgzOqMqzjK71TFOQsJdGEYThnhiL2FoQeptgskVS7J9MMBPTnyl7D YObINwGbg9auVp66rj5W+dymZwKBgQDB6VdpxJpU9hXBW+8nJESduhzpYiHoe1kN yka90dQDOe2b/R7bnF1Ggte6Ll1dMs3xLhN1Mm2XTcX2zmzM15C0E4+1t1LXXzAo O2P+riEmCIUc1i0yNMVgEKXiOBBYgKauE3fT88c4dw2JAT0QlifJ0h8kRPNhUaq9 espjleNQwQKBgHUzwZ7knn2qmSb1M9PTHppseWJfoPexXrGHZyHK064ykDcpos+4 FuWO4U+G4GQxPDiXMaLI6IsGBUHVnsHdyruC/9O7+S5hw7Zu9CLcdy6TQSZwPcAM wbxyJnSdMYvgM1roz2ELb6nPdXE5qwMN8i8/euzcmDgBBDkZLKuamE+lAoGBAKb7 vd7DAvPvBkUAWi2mub/pqUQA0ZpVvhZ1/f0wWBZ/J/KQQqZzPI+f1Q3rJ1M+kMIE H5Vo257TxooGsQKlD2NDBRpCx//XZK0Al9eVM86Av8BZX4pAj0dujqsEBG9yOhbl hObsor4pJ2q3ulIyPAk7/L1K8xr3LMUGnIqtZJcBAoGAEQffqGbnaOG8Ue3++bLP N6XlAyt5UajAd1CycIHgDvbW0CkWoI70Bg7QNqMYJe6DareH4vRpdB3tw6zNP7qN 0Bd04L8+zUYN+VqNJ70d7Xn+k2rY7STlgU3vwOzHFwu4wK2A7e+aAZ8AjC+Sr0ZM ps+wuWO8MN5yQTBZvAEIfQs= -----END PRIVATE KEY----- ' private_key_id: 1935e74178f6ef0bbc23fb3538255f8281093bf2 project_id: platform-development token_uri: https://oauth2.googleapis.com/token type: service_account universe_domain: googleapis.com id: '123' name: slack links: first: https://api.magicbell.com/v1/example next: https://api.magicbell.com/v1/example?page[next]=abc prev: null CreateUserTokenRequest: type: object properties: email: maxLength: 255 type: string description: The user's email. expiry: minimum: 1 type: integer description: The duration for which the token is valid (in seconds) external_id: maxLength: 255 type: string description: A unique string that MagicBell can utilize to identify the user uniquely. We recommend setting this attribute to the ID of the user in your database. Provide the external id if the user's email is unavailable. name: maxLength: 255 type: string description: The name of the token. example: email: hana@magicbell.io expiry: 3600 name: Hana's token SlackTokenResponse: required: - created_at - id type: object properties: created_at: type: string format: date-time discarded_at: type: string format: date-time nullable: true id: type: string oauth: required: - channel_id - installation_id type: object properties: channel_id: type: string installation_id: type: string scope: type: string updated_at: type: string format: date-time nullable: true webhook: required: - url type: object properties: url: minLength: 1 type: string format: uri example: created_at: '2021-01-01T00:00:00Z' discarded_at: '2021-01-01T00:00:00Z' id: '123' updated_at: '2021-01-01T00:00:00Z' webhook: url: https://example.com/webhook