Get a Mailbox Alias

This is the GraphQL query to run when you want to get the mailbox alias for a given mailbox.

What's a Mailbox Alias?

Every email address on Maildrop has a corresponding "Mailbox Alias", which is an encoded two-way-hash of the email address itself, with the secret key for the hash known only to Maildrop.

This means, if you wanted to give someone the address "" but didn't want them to be able to go to the site and read that mailbox, you could give them the mailbox alias, for example "". Messages sent to this mailbox alias would still go to but the sender wouldn't know the true destination.

This serves as an additional layer of security if you're concerned about others getting access to the mailbox.

Each mailbox on the site has this section which includes the mailbox alias:

If you're using Maildrop in an automated fashion it's unlikely that you'll need to query for the mailbox alias - it's more useful for you to just create a unique address that only you know (for example, a uuidv4 address @

Gets the Mailbox Alias for a given mailbox.


Retrieves the Mailbox Alias for the address in the query. The query does not need to contain the entire email address, just the username portion. For example, "" only needs "test" as the query parameter.


Request Body

    "data": {
        "altinbox": "D-1lp8kheq"


curl --request POST \
    --header 'content-type: application/json' \
    --url \
    --data '{"query":"query Example {\n altinbox(mailbox:\"testing\") }"



Last updated