{"info":{"_postman_id":"89b60f1b-5101-40d8-82fa-027d917e66f3","name":"Auth-Mailer-API","description":"

📑 Auth-Mailer-API – Postman Documentation

Auth-Mailer-API is a RESTful service that provides user authentication and email sending capabilities. This documentation is designed for Postman to help developers test, explore, and integrate the API quickly.

🔑 Authentication

Type: JWT (JSON Web Token)
\n
CódigoAuthorization: Bearer
\n

📬 Base URL

Código

https://auth-mailer-api.onrender.com\n\n

⚠️ Error Responses

400 Bad Request: Missing or invalid parameters.
\n
401 Unauthorized: Invalid or missing token.
\n
404 Not Found: Resource not found.
\n
500 Internal Server Error: Unexpected server issue.
\n

🛠️ Postman Setup

Import this collection into Postman.
\n
Set the Base URL as an environment variable ({{base_url}}).
\n
Add an Authorization header with your JWT token.
\n
Test endpoints individually or chain them in workflows.
\n

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"📑 Auth-Mailer-API – Postman Documentation","slug":"auth-mailer-api-postman-documentation"}],"owner":"48309056","collectionId":"89b60f1b-5101-40d8-82fa-027d917e66f3","publishedId":"2sB3dQwAK2","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-12-09T23:02:17.000Z"},"item":[{"name":"Users","item":[{"name":"Get All Users","id":"fdade220-e65a-4ba7-b8ae-fa3c795b1a4b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyIjp7ImlkIjoxMiwiZW1haWwiOiJjbGlvYW5haGlAZ21haWwuY29tIiwiZmlyc3ROYW1lIjoiQ2xpbyIsImxhc3ROYW1lIjoiU2FsZ2FkbyIsImNvdW50cnkiOiJNZXhpY28iLCJpbWFnZSI6Imh0dHBzOi8veHNnYW1lcy5jby9yYW5kb211c2Vycy9hc3NldHMvYXZhdGFycy9mZW1hbGUvMTQuanBnIiwiaXNWZXJpZmllZCI6dHJ1ZSwiY3JlYXRlZEF0IjoiMjAyNS0xMi0wOVQyMTo0MzoxNC41NjBaIiwidXBkYXRlZEF0IjoiMjAyNS0xMi0wOVQyMTo0NTozNS40NDJaIn0sImlhdCI6MTc3NTQxMjMxMSwiZXhwIjoxNzc1NDk4NzExfQ._AsdbbphLY9O8B7IdkWLsj6xWY8wnu6hJDIBmVNSpII","type":"text"}],"url":"https://auth-mailer-api.onrender.com/users","description":"

Description: Retrieves a list of all registered users.

Correct Response:

[\n    {\n        \"id\": 6,\n        \"email\": \"clioanahisalgado@gmail.com\",\n        \"firstName\": \"Anahi\",\n        \"lastName\": \"Aguayo\",\n        \"country\": \"Mexico\",\n        \"image\": \"https://xsgames.co/randomusers/assets/avatars/female/14.jpg\",\n        \"isVerified\": true,\n        \"createdAt\": \"2025-12-09T01:41:39.255Z\",\n        \"updatedAt\": \"2025-12-09T19:57:22.649Z\"\n    }\n]\n\n

\n","urlObject":{"path":["users"],"host":["https://auth-mailer-api.onrender.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"fdade220-e65a-4ba7-b8ae-fa3c795b1a4b"},{"name":"Create User","id":"d046f3cc-66a5-4375-986c-c7957c4823e0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\": \"clioanahi@gmail1.com\",\r\n \"password\": \"123456\",\r\n \"firstName\": \"Clio\",\r\n \"lastName\": \"Salgado\",\r\n \"country\": \"Mexico\",\r\n \"image\": \"https://xsgames.co/randomusers/assets/avatars/female/14.jpg\",\r\n \"frontBaseUrl\": \"https://auth-mailer-api.netlify.app/auth/verify_email\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://auth-mailer-api.onrender.com/users","description":"

Description: Create a new user into database.

Correct Response:

{\n    \"message\": \"User created successfully!\",\n    \"user\": {\n        \"isVerified\": false,\n        \"id\": 13,\n        \"email\": \"clioanahi@gmail.com\",\n        \"firstName\": \"Clio\",\n        \"lastName\": \"Salgado\",\n        \"country\": \"Mexico\",\n        \"image\": \"https://xsgames.co/randomusers/assets/avatars/female/14.jpg\",\n        \"updatedAt\": \"2025-12-09T22:29:32.222Z\",\n        \"createdAt\": \"2025-12-09T22:29:32.222Z\"\n    }\n}\n\n

\n","urlObject":{"path":["users"],"host":["https://auth-mailer-api.onrender.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"d046f3cc-66a5-4375-986c-c7957c4823e0"},{"name":"Delete User","id":"c987b175-84f9-44e1-9ff7-d9bab32360f6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"Authorization","value":"Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyIjp7ImlkIjoxMiwiZW1haWwiOiJjbGlvYW5haGlAZ21haWwuY29tIiwiZmlyc3ROYW1lIjoiQ2xpbyIsImxhc3ROYW1lIjoiU2FsZ2FkbyIsImNvdW50cnkiOiJNZXhpY28iLCJpbWFnZSI6Imh0dHBzOi8veHNnYW1lcy5jby9yYW5kb211c2Vycy9hc3NldHMvYXZhdGFycy9mZW1hbGUvMTQuanBnIiwiaXNWZXJpZmllZCI6dHJ1ZSwiY3JlYXRlZEF0IjoiMjAyNS0xMi0wOVQyMTo0MzoxNC41NjBaIiwidXBkYXRlZEF0IjoiMjAyNS0xMi0wOVQyMTo0NTozNS40NDJaIn0sImlhdCI6MTc3NTQxMjMxMSwiZXhwIjoxNzc1NDk4NzExfQ._AsdbbphLY9O8B7IdkWLsj6xWY8wnu6hJDIBmVNSpII","type":"text"}],"url":"https://auth-mailer-api.onrender.com/users/96","description":"

Description: Delete one user by ID.

Correct Response:

","urlObject":{"path":["users","96"],"host":["https://auth-mailer-api.onrender.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"c987b175-84f9-44e1-9ff7-d9bab32360f6"},{"name":"Verify Email","id":"53d7e4ee-baa2-4868-ab17-0a27b4bfb5e2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://auth-mailer-api.onrender.com/users/verify/98318bf65c21ea227d75456522a642aea63b515273e98fe41624f6c8859bb6bc","description":"

Description: Verify the email user.

Correct Response:

","urlObject":{"path":["users","verify","98318bf65c21ea227d75456522a642aea63b515273e98fe41624f6c8859bb6bc"],"host":["https://auth-mailer-api.onrender.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"53d7e4ee-baa2-4868-ab17-0a27b4bfb5e2"},{"name":"Login","id":"6522f6f1-8495-49fa-9194-b5eb1a29027b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\": \"clioanahi@gmail.com\",\r\n \"password\": \"789101\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://auth-mailer-api.onrender.com/users/login","description":"

Description: Login User into API.

Correct Response:

{\n    \"message\": \"Correct Login\",\n    \"token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyIjp7ImlkIjoxMiwiZW1haWwiOiJjbGlvYW5haGlAZ21haWwuY29tIiwiZmlyc3ROYW1lIjoiQ2xpbyIsImxhc3ROYW1lIjoiU2FsZ2FkbyIsImNvdW50cnkiOiJNZXhpY28iLCJpbWFnZSI6Imh0dHBzOi8veHNnYW1lcy5jby9yYW5kb211c2Vycy9hc3NldHMvYXZhdGFycy9mZW1hbGUvMTQuanBnIiwiaXNWZXJpZmllZCI6dHJ1ZSwiY3JlYXRlZEF0IjoiMjAyNS0xMi0wOVQyMTo0MzoxNC41NjBaIiwidXBkYXRlZEF0IjoiMjAyNS0xMi0wOVQyMTo0NTozNS40NDJaIn0sImlhdCI6MTc2NTMxOTk2MCwiZXhwIjoxNzY1NDA2MzYwfQ.NsSCJeoGFSle8-a7mNhpFWhkvqpdLYJKaKbdnPo48f4\",\n    \"user\": {\n        \"id\": 12,\n        \"email\": \"clioanahi@gmail.com\",\n        \"firstName\": \"Clio\",\n        \"lastName\": \"Salgado\",\n        \"country\": \"Mexico\",\n        \"image\": \"https://xsgames.co/randomusers/assets/avatars/female/14.jpg\",\n        \"isVerified\": true,\n        \"createdAt\": \"2025-12-09T21:43:14.560Z\",\n        \"updatedAt\": \"2025-12-09T21:45:35.442Z\"\n    }\n}\n\n

\n","urlObject":{"path":["users","login"],"host":["https://auth-mailer-api.onrender.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"6522f6f1-8495-49fa-9194-b5eb1a29027b"},{"name":"Get One User","id":"8e0eb437-374f-49f9-ab80-8e5b38dd63d7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyIjp7ImlkIjozLCJlbWFpbCI6Inp5YmFyaXRlQHByb3Rvbi5tZSIsImZpcnN0TmFtZSI6IkNhc3RvbGl0byIsImxhc3ROYW1lIjoiQmIiLCJjb3VudHJ5IjoiTcOpeGljbyIsImltYWdlIjoiaHR0cHM6Ly94c2dhbWVzLmNvL3JhbmRvbXVzZXJzL2Fzc2V0cy9hdmF0YXJzL21hbGUvNy5qcGciLCJpc1ZlcmlmaWVkIjp0cnVlLCJjcmVhdGVkQXQiOiIyMDI1LTEyLTA5VDAxOjIyOjU3Ljk1OFoiLCJ1cGRhdGVkQXQiOiIyMDI1LTEyLTA5VDAxOjIzOjQxLjI2MloifSwiaWF0IjoxNzY1MjQzNjA2LCJleHAiOjE3NjUzMzAwMDZ9.Ld3lKkUe-9P3C7vCiVH076nM_GtVIC_ct1EzGyBpWHQ","type":"text"}],"url":"https://auth-mailer-api.onrender.com/users/3","description":"

Description: Get One User by ID.

Correct Response:

{\n    \"id\": 3,\n    \"email\": \"zybarite@proton.me\",\n    \"firstName\": \"Israel\",\n    \"lastName\": \"Ramírez\",\n    \"country\": \"Mexico\",\n    \"image\": \"https://xsgames.co/randomusers/assets/avatars/male/7.jpg\",\n    \"isVerified\": true,\n    \"createdAt\": \"2025-12-09T01:22:57.958Z\",\n    \"updatedAt\": \"2025-12-09T21:46:09.101Z\"\n}\n\n

\n","urlObject":{"path":["users","3"],"host":["https://auth-mailer-api.onrender.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"8e0eb437-374f-49f9-ab80-8e5b38dd63d7"},{"name":"Reset Password","id":"b4786b72-cf5c-4fa7-b51d-cf6780c0fc64","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\": \"clioanahisalgado@gmail.com\",\r\n \"frontBaseUrl\": \"https://auth-mailer-api.netlify.app/auth/reset_password\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://auth-mailer-api.onrender.com/users/reset_password","description":"

Description: Reset user password.

Correct Response:

","urlObject":{"path":["users","reset_password"],"host":["https://auth-mailer-api.onrender.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"b4786b72-cf5c-4fa7-b51d-cf6780c0fc64"},{"name":"Update Password","id":"4afc79a4-67ee-4195-83c0-f95eb2375a88","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"password\": \"789101\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://auth-mailer-api.onrender.com/users/reset_password/f9eb2f39d7920052f89d9916be0fc10bacc4bd50fc72b1d03c8b5737ced363c4","description":"

Description: Update user password into db.

Correct Response:

","urlObject":{"path":["users","reset_password","f9eb2f39d7920052f89d9916be0fc10bacc4bd50fc72b1d03c8b5737ced363c4"],"host":["https://auth-mailer-api.onrender.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"4afc79a4-67ee-4195-83c0-f95eb2375a88"},{"name":"Update User","id":"91f07ae3-b14d-479e-8697-97b00a2a2d3a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[{"key":"Authorization","value":"Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyIjp7ImlkIjozLCJlbWFpbCI6Inp5YmFyaXRlQHByb3Rvbi5tZSIsImZpcnN0TmFtZSI6IkNhc3RvbGl0byIsImxhc3ROYW1lIjoiQmIiLCJjb3VudHJ5IjoiTcOpeGljbyIsImltYWdlIjoiaHR0cHM6Ly94c2dhbWVzLmNvL3JhbmRvbXVzZXJzL2Fzc2V0cy9hdmF0YXJzL21hbGUvNy5qcGciLCJpc1ZlcmlmaWVkIjp0cnVlLCJjcmVhdGVkQXQiOiIyMDI1LTEyLTA5VDAxOjIyOjU3Ljk1OFoiLCJ1cGRhdGVkQXQiOiIyMDI1LTEyLTA5VDAxOjIzOjQxLjI2MloifSwiaWF0IjoxNzY1MjQzNjA2LCJleHAiOjE3NjUzMzAwMDZ9.Ld3lKkUe-9P3C7vCiVH076nM_GtVIC_ct1EzGyBpWHQ","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"email\": \"zybarite@proton.me\",\r\n \"firstName\": \"Israel\",\r\n \"lastName\": \"Ramírez\",\r\n \"country\": \"Mexico\",\r\n \"image\": \"https://xsgames.co/randomusers/assets/avatars/male/7.jpg\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://auth-mailer-api.onrender.com/users/3","description":"

Description: Update user into db.

Correct Response:

","urlObject":{"path":["users","3"],"host":["https://auth-mailer-api.onrender.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"91f07ae3-b14d-479e-8697-97b00a2a2d3a"}],"id":"39e699db-9bbd-4108-8545-cd33536d011e","description":"

The Users folder contains endpoints related to user management in the Auth-Mailer-API. These endpoints allow developers to register, authenticate, and manage users within the system.

📌 Endpoints

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Method	Endpoint	Description	Authorization
GET	`/users`	Get all users	Token is Required
GET	`/users/:id`	Get a single user by ID	Token is Required
POST	`/users`	Create a new user	Not Required
PUT	`/users/:id`	Update an existing user	Token is required
DELETE	`/users/:id`	Delete an user by ID	Token is required
GET	`/users/verify/:code`	Verify user email with code from email_codes	Not Required
POST	`/users/login`	Login User	Not Required
POST	`/users/reset_password`	Resest user password	Not Required
POST	`/users/reset_password/:code`	Update password with code generated from email_codes	Not required

","_postman_id":"39e699db-9bbd-4108-8545-cd33536d011e"}],"event":[{"listen":"prerequest","script":{"id":"f3b500c0-ba88-4171-ada0-71f62464fc73","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"9558a46d-ef8d-4e71-8101-1c4c80d85b9c","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}],"variable":[{"key":"BASE_URL","value":"https://auth-mailer-api.onrender.com"}]}