Recibir correos: Identidad
Whoami
Devuelve a qué buzón pertenece esta credencial y detalles de la propia credencial, sin leer ningún mensaje. Úsalo para verificar que una credencial pertenece a un buzón concreto.
https://g.sendcorex.com/v1command: whoamiTodos los campos de token, salvo type, solo se devuelven cuando la credencial es un token de buzón (mailbox_token). Los tokens de acceso OAuth devuelven solo token.type.
Argumentos
Este endpoint no recibe argumentos.
Inicio rápido
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1',
{
commands: [
{
command: "whoami"
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_TOKEN } },
);
const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);Respuesta
{
"type": "SUCCESS",
"results": [
{
"command": "whoami",
"id": "0",
"type": "SUCCESS",
"data": {
"mailbox": {
"email": "support@acme.com",
"from_name": "Acme Support",
"sender_ref": "snd_7Kq2Xr9P"
},
"token": {
"type": "mailbox_token",
"id": "mbt_3Fh8LwQ1",
"name": "Helpdesk bot",
"prefix": "scx_mb_4f9a",
"created_at": "2026-10-02T09:14:00.000Z",
"expires_at": null,
"last_used_at": "2026-11-19T00:31:12.000Z"
}
}
}
]
}Campos de la respuesta
mailbox.emailLa dirección del buzón al que pertenece esta credencial.
mailbox.from_nameEl nombre que se muestra al enviar desde este buzón.
mailbox.sender_refLa referencia del perfil de remitente de este buzón.
token.typemailbox_tokenpara un token de buzón,oauthpara un token de acceso OAuth.token.idEl ID del token. Solo para
mailbox_token.token.nameEl nombre que se le dio al token. Solo para
mailbox_token.token.prefixLos primeros caracteres del token, tal como aparecen en el panel. Solo para
mailbox_token.token.created_atCuándo se creó el token. Solo para
mailbox_token.token.expires_atCuándo caduca el token, o
nullsi no caduca. Solo paramailbox_token.token.last_used_atLa última vez que se usó el token, o
null. Solo paramailbox_token.
Errores
Los errores a nivel HTTP devuelven type, code y message. Los errores marcados con CMD vuelven dentro del resultado del comando, con HTTP 200.
- 401
TOKEN_EXPIREDEl access token expiró. Llama a Refresh Token y repite la solicitud.
- 401
INVALID_TOKENEl token está mal formado, es desconocido o fue revocado.
- 429
RATE_LIMITEDMás de 15 solicitudes/s o 15 en curso para la misma IP + buzón. Espera la cantidad de segundos indicada en Retry-After.
- CMD
INTERNALError del servidor. El detalle solo se escribe en el log del servidor.