MirrorBox for developers

Let your users link their MirrorBox account and show their wall on their profile on your site, with an anonymous “Ask me” box that sends to their inbox.

1. Register & test

Create an app below and build your integration with your own test accounts.

2. Apply

Tell us about your site: its content, audience and how you’ll use MirrorBox. We review every site.

3. Go live

Once approved, everyone can link their MirrorBox and you can show walls on profiles.

Quick start

<script src="https://mirrorbox.me/sdk/v1/wall.js" async></script>

<!-- A linked user's wall, by the sub your server got from /oauth/token -->
<mirrorbox-wall client-id="mbx_app_…" sub="mbx_…"></mirrorbox-wall>

<!-- After approval: any wall whose owner lets approved sites show it -->
<mirrorbox-wall client-id="mbx_app_…" handle="mina"></mirrorbox-wall>

<!-- Start linking (code_challenge = BASE64URL(SHA256(verifier))) -->
<mirrorbox-link-button client-id="mbx_app_…" redirect-uri="https://you.example/cb"
  scope="profile wall:read reading:write offline_access" state="…" code-challenge="…">
</mirrorbox-link-button>

Server endpoints: POST /api/v1/oauth/token, POST /api/v1/oauth/revoke, GET /api/v1/partner/me, PUT /api/v1/partner/me/now-reading, GET /api/v1/partner/walls/:handle. Webhooks are signed with MirrorBox-Signature: t=…,v1=HMAC-SHA256(secret, t + "." + body).

Your apps