Skip to main content
Cada alcance es una puerta en su clave: abra solo lo que su integración necesita — dominio, envío, lectura o cancelación.
Cada alcance desbloquea un tipo de operación de correo electrónico. Use solo lo que su integración necesita.

​
Cómo enviar la clave

Recomendado
Alternativo
Cada clave API pertenece a un espacio de trabajo. No puede acceder a otro espacio de trabajo con la misma clave.

​
Combinaciones comunes

Solo enviar

email:send

Enviar y consultar

email:send, email:read

Con programación

email:send, email:cancel

Setup completo

email:domains:create, email:domains:list, email:send, email:read
Lista de alcances vacía al crear = acceso ADMIN (todo). En producción, restrinja siempre.

​
Alcances disponibles

Enviar correo inmediato o programado. El dominio from debe estar VERIFICADO.
  • Listar correos enviados en el espacio de trabajo
  • Consultar un envío por id
Con domainIds en la clave, la lista se limita a esos dominios.
Cancelar correo programado. Solo con estado SCHEDULED. Créditos reembolsados.
Listar dominios, ver detalles y verificar estado DNS.
Registrar un nuevo dominio para verificación DNS.

​
Límite por dominio

Si la clave tiene domainIds configurados, solo puede enviar con direcciones from de esos dominios. Dominio fuera de la lista → 403 (DOMAIN_NOT_ALLOWED). Lista vacía = cualquier dominio VERIFICADO en el espacio de trabajo.

​
Errores comunes

Verifique Authorization: Bearer sk_... y que la clave no se eliminó en el panel.
Verifique el alcance de la ruta, domainIds en la clave y los créditos (PLAN_LIMIT_CREDITS).
Verifique el dominio from en el panel antes de enviar.

​
Próximos pasos