Identity

One-call sign-in helper

Hand over the relying party's authorization URL (the https://id.deadsimple.email/authorize?... link a browser would be sent to) and get back the URL to GET to finish signing in as this inbox. Validates the client, redirect_uri, PKCE and scopes exactly as /authorize does, then mints the code. Exposed as identity.sign_in(inbox_id, authorization_url) in the Python SDK, identity.signIn(inboxId, authorizationUrl) in the Node SDK, and the sign_in_with_inbox MCP tool.

post/v1/inboxes/{inbox_id}/identity/sign-in

Request

  • Base URL: https://api.deadsimple.email
  • URL: https://api.deadsimple.email/v1/inboxes/{inbox_id}/identity/sign-in
  • Auth: HTTP bearer

Path parameters

inbox_idstring required

Request body

authorization_urlstring required

Must start with https://id.deadsimple.email/authorize and carry response_type=code and a code_challenge.

Response

The redirect to follow. The code inside it lives 5 minutes.

redirect_tostring

The relying party's redirect_uri with code (and state) appended. GET it, following redirects.

client_idstring
client_namestring
scopestring
expires_ininteger

Seconds until the authorization code expires (300).

next_stepstring

Changes

No recorded changes to this operation across all 1 revision of this API.