Set the active test_id: all subsequent calls are filtered/persisted with it. Pass null/None to go back to the global queue.

Set the active app (a name registered in MockPost): incoming event simulations and queries are filtered/delivered only to that app. Pass null/None for no app. Register apps with register_app.

Register or update an app: bind its FAKE credentials (Telegram bot token, Twilio SID, Stripe sk_test_, WhatsApp phone_id, FCM project_id) to a name. The app talks to MockPost using those credentials as if it were the real service; MockPost identifies it by them. Use the same name to update creds.

List registered apps with their fake credentials (MockPost identity).

Delete a registered app. Its webhooks become global.

Webhook delivery history: what each app returned (code + body), even if it was down (response_code 0). Filterable by channel and app.

List captured messages for a channel (or all), newest first. channel: mail|telegram|whatsapp|webpush|sms|fcm|apns|slack|discord|stripe app: registered app name to filter only its messages.

Return a message's full payload, including raw_payload (MIME/JSON).

Fire a delivery status webhook (delivered|read|failed) back to the app. Uses POST /whatsapp/simulate/status.

Simulate an external user sending an inbound message to the app. channel: telegram (via /telegram/client/sendMessage) or whatsapp. app: registered app name to target; overrides set_app for this call.

Build and send a simulated Stripe event, signed (Stripe-Signature), to the registered webhook. app: registered app name to target; overrides set_app for this call.

Fire a GitHub webhook event (push, issues, pull_request) signed with X-Hub-Signature-256 to the app's registered GitHub webhook. app: registered app name to target; overrides set_app for this call.

Fire a Facebook Graph API webhook event signed with X-Hub-Signature-256 to the app's registered Facebook webhook. app: registered app name to target; overrides set_app for this call.

Fire an X (Twitter) Account Activity webhook event signed with X-Twitter-Webhooks-Signature to the app's registered X webhook. payload is a list of event objects, as the real API delivers. app: registered app name to target; overrides set_app for this call.

Verify a Facebook webhook subscription (hub.mode/hub.verify_token/ hub.challenge) as Meta does on registration. Returns the challenge URL.

Create a Web Push subscription and return it shaped exactly like the browser's PushSubscription (endpoint + keys.p256dh + keys.auth). Hand it to the app under test: MockPost keeps the private key, so when the backend sends the encrypted push with pywebpush or web-push it verifies the VAPID signature, decrypts the payload and captures the cleartext.

List Web Push subscriptions with their endpoint and status (active|gone).

Mark a Web Push subscription as gone: the next push answers 410, which is how a backend learns it must delete a dead subscription.

Make a native push token look uninstalled: FCM answers 404 UNREGISTERED and APNs answers 410 Unregistered on the next send. channel: fcm | apns

Return the latest OTP code (SMS or email) sent to an identifier.

Generate and store a TOTP secret (Google Authenticator). Returns base32 secret and otpauth:// URL.

Compute the current TOTP code (6 digits) for a previously generated secret. Window ±1.

Set the profile the fake OAuth provider (google|github|facebook|x) returns on the next login.

Inspect a simulated OAuth session: code, tokens, returned profile and expiry.

Return host/port/base URL/fake tokens the app must use for that channel.

Register an app webhook (Telegram setWebhook, WhatsApp, Stripe...). If you pass an app (registered name), the webhook only receives events from that app.

List registered webhooks, optionally filtered by channel and app.

Fire a test event to a registered webhook and return the app's response.

Delete all captured messages of a channel (cleanup between test runs). With app, only that app's messages.

Delete all captured messages (or only those of a test_id/app).

FULL TIMELINE as Markdown: messages + webhook_events + stripe_events in chronological order. Call this first when verifying a test result; use get_message_detail only for a single event's detail. With app, only that app's events.