Referencia de API
Crea integraciones potentes con la API de Icebox. Accede a correos, contactos y mas de forma programatica.
Diseno RESTful
URLs limpias y predecibles con metodos HTTP estandar
Seguro por Defecto
Opciones de autenticacion OAuth 2.0 y clave API
Webhooks en Tiempo Real
Recibe notificaciones instantaneas cuando ocurren eventos
SDKs Oficiales
Bibliotecas para lenguajes y frameworks populares
https://api.icebox.cool/v1Inicio Rapido
Comienza a usar la API de Icebox en minutos.
// Install the SDK
npm install @icebox/sdk
// Initialize the client
import { Icebox } from '@icebox/sdk';
const icebox = new Icebox({
apiKey: 'your_api_key_here'
});
// Fetch emails from inbox
const emails = await icebox.emails.list({
folder: 'inbox',
limit: 10
});
console.log(emails);curl -X GET "https://api.icebox.cool/v1/emails" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"{
"data": [
{
"id": "msg_abc123",
"subject": "Welcome to Icebox",
"from": {
"email": "hello@icebox.cool",
"name": "Icebox Team"
},
"date": "2025-01-15T10:30:00Z",
"snippet": "Thanks for signing up...",
"labels": ["inbox", "unread"]
}
],
"pagination": {
"total": 156,
"page": 1,
"per_page": 10
}
}Endpoints de API
Explora los endpoints disponibles organizados por recurso.
Correos
Envia, recibe y gestiona mensajes de correo
/emailsListar todos los correos/emails/{id}Obtener un correo especifico/emailsEnviar un nuevo correo/emails/{id}Actualizar metadatos del correo/emails/{id}Eliminar un correoContactos
Gestiona tu libreta de direcciones e informacion de contacto
/contactsListar todos los contactos/contacts/{id}Obtener un contacto especifico/contactsCrear un nuevo contacto/contacts/{id}Actualizar un contacto/contacts/{id}Eliminar un contactoCarpetas y Etiquetas
Organiza correos con carpetas y etiquetas
/foldersListar todas las carpetas/foldersCrear una nueva carpeta/labelsListar todas las etiquetas/labelsCrear una nueva etiquetaWebhooks
Recibe notificaciones en tiempo real de eventos
/webhooksListar suscripciones de webhook/webhooksCrear un webhook/webhooks/{id}Eliminar un webhookCuenta
Gestiona configuracion y preferencias de cuenta
/accountObtener detalles de cuenta/accountActualizar configuracion de cuenta/account/usageObtener estadisticas de uso de APIAdjuntos
Sube y descarga adjuntos de correo
/attachments/{id}Descargar adjunto/attachmentsSubir adjunto/attachments/{id}Eliminar adjuntoSDKs Oficiales
Usa nuestras bibliotecas oficiales para integrar mas rapido.
JavaScript / TypeScript
npm install @icebox/sdkPython
pip install icebox-sdkRuby
gem install iceboxGo
go get github.com/icebox/sdk-goLimites de Tasa
Los limites de tasa de API se basan en tu nivel de suscripcion.
Autenticacion
Todas las solicitudes de API requieren autenticacion via clave API o token OAuth 2.0. Incluye tus credenciales en el encabezado Authorization.
Authorization: Bearer YOUR_API_KEYListo para comenzar?
Crea una clave API y comienza a construir tu integracion hoy.