Mailjs

A JavaScript wrapper around the mail.tm api.

Probably one of the best API for creating temporary email accounts.

Installation

NPM

npm install @cemalgnlts/mailjs

CDN

https://cdn.jsdelivr.net/gh/cemalgnlts/Mailjs@latest/Mailjs.min.js

Documentation

Returns a Promise object after the function is called. If the request is sent correctly, status returns true. If it returns incorrect, the status will be false and the message in the data is also added.

A successfull response example:

{
  "status": true,
  "message": "ok",
  "data": ...
}

A failed response example:

{
  "status": false,
  "message": "Invalid credentials.",
  "data": ...
}

To see all results, check out the API page: https://api.mail.tm/

User needs to login to access JWT token. Registration does not return this information, log in after registration.

After the login process, the user's JWT token and ID are assigned to mailjs.token and mailjs.id

Domain

List Domains

mailjs.getDomains()
  .then(console.log)

Get Domain

mailjs.getDomain("[domain id]")
  .then(console.log)

Account

Create Account

mailjs.register("user@example.com", "password")
  .then(console.log)

Login

mailjs.token and mailjs.id can be used to access the user token and id later.

mailjs.login("user@example.com", "password")
  .then(console.log)

Get Account Data

mailjs.me()
  .then(console.log)

Delete Account

mailjs.deleteMe()
  .then(console.log)

You can also use the id to access the user's information and delete their account.

mailjs.deleteAccount("[account id]")
  .then(console.log)

mailjs.getAccount("[account id]")
  .then(console.log)

Message

List messages

mailjs.getMessages()
  .then(console.log)

Read a message

mailjs.getMessage("[message id]")
  .then(console.log)

Delete a message

mailjs.deleteMessage("[message id]")
  .then(console.log)

Make a message readed or unreaded.

true for make readed. false for make unreaded.

mailjs.setMessageSeen("[message id]", true)
  .then(console.log)

Source

Get source

mailjs.getSource("[message id]")
  .then(console.log)

Helper Methods

Create random account.

Creates and logs in an account with a random username and password.

mailjs.createOneAccount()
  .then(console.log);

Response

{
  "status": true,
  "data": {
    "username": "user@example.com",
    "password": "my-password"
  }
}

carlsmei/Mailjs