---
title: Inicio rápido
description: Crea una cuenta, verifica un dominio, genera una clave de API y envía tu primer email con curl o el SDK de Node.js; prueba con el simulador de SES.
seo:
  title: "Inicio rápido: envía tu primer email"
ai:
  exclude: true
---

## 1. Regístrate

Crea una cuenta en [billionsend.com](https://billionsend.com). El panel está allí; la API está en `https://api.billionsend.com`.

## 2. Verifica un dominio

Solo puedes enviar desde dominios que hayas verificado.

1. Abre **Dominios** y añade un dominio tuyo, por ejemplo `acme.dev`.
2. Añade en tu proveedor de DNS los registros que se muestran (DKIM y MAIL FROM).
3. Haz clic en **Verificar dominio**. La página muestra qué registros faltan todavía.

Consulta [Dominios](/docs/es/concepts/domains).

## 3. Crea una clave de API

Abre **Claves de API** y crea una. La clave `bs_` se muestra una sola vez, así que cópiala. Una clave puede tener acceso completo o solo de envío, y puede limitarse a un dominio.

## 4. Envía un email

Con curl:

```sh
curl -X POST https://api.billionsend.com/emails \
  -H "Authorization: Bearer bs_..." \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Acme <onboarding@acme.dev>",
    "to": ["success@simulator.amazonses.com"],
    "subject": "Hello from BillionSend",
    "html": "<strong>It works!</strong>"
  }'
```

O con el SDK de Node.js (`npm install @billionsend/node`):

```ts
import { BillionSend } from "@billionsend/node";

const bs = new BillionSend("bs_..."); // o new BillionSend() con BILLIONSEND_API_KEY definida

const { data, error } = await bs.emails.send({
  from: "Acme <onboarding@acme.dev>",
  to: ["success@simulator.amazonses.com"],
  subject: "Hello from BillionSend",
  html: "<strong>It works!</strong>",
});

if (error) console.error(error.name, error.message);
else console.log("sent", data.id);
```

Ambos devuelven `{ "id": "..." }`. Mira cómo el email pasa de `queued` a `delivered` en la página **Emails**. Otros lenguajes: consulta [SDKs](/docs/es/sdks).

## Pruebas

- `success@simulator.amazonses.com` simula una entrega sin enviar email a nadie. Añade una etiqueta para variar: `success+signup@simulator.amazonses.com`.
- Los emails al simulador también cuentan en la cuota de tu plan.
- `bounce@`, `complaint@` y `suppressionlist@` en el simulador generan rebotes y quejas reales: la dirección entra en tu [lista de supresión](/docs/es/concepts/suppressions) y el evento activa tus webhooks, pero la respuesta del simulador nunca cuenta en tus tasas de rebote y de quejas. Úsalos a mano, no en pruebas automatizadas. Cada dirección funciona una sola vez, así que añade una etiqueta para obtener una nueva: `bounce+2@simulator.amazonses.com`.
- Las direcciones en `example.com`, o que terminan en `.test` o `.invalid`, no pueden recibir correo. Un envío a una de ellas se rechaza con `422` (consulta los [Conceptos básicos de la API](/docs/es/api-reference/basics)).

## Siguientes pasos

- [Emails](/docs/es/concepts/emails), [Contactos](/docs/es/concepts/contacts) y [Envíos masivos](/docs/es/concepts/broadcasts).
- [SDKs](/docs/es/sdks) para tu lenguaje.
- [Referencia de la API](/docs/es/api-reference) con todos los endpoints.
