---
title: Início rápido
description: Envie seu primeiro e-mail em poucos minutos.
ai:
  exclude: true
---

## 1. Cadastre-se

Crie uma conta em [billionsend.com](https://billionsend.com). O painel fica lá; a API fica em `https://api.billionsend.com`.

## 2. Verifique um domínio

Você só pode enviar de domínios que verificou.

1. Abra **Domínios** e adicione um domínio seu, por exemplo `acme.dev`.
2. Adicione no seu provedor de DNS os registros mostrados (DKIM e MAIL FROM).
3. Clique em **Verificar domínio**. A página mostra quais registros ainda faltam.

Veja [Domínios](/docs/pt-br/concepts/domains).

## 3. Crie uma chave de API

Abra **Chaves de API** e crie uma. A chave `bs_` aparece uma única vez, então copie. Uma chave pode ter acesso total ou apenas de envio, e pode ser limitada a um domínio.

## 4. Envie um e-mail

Com 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>"
  }'
```

Ou com o SDK para Node.js (`npm install @billionsend/node`):

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

const bs = new BillionSend("bs_..."); // or new BillionSend() with BILLIONSEND_API_KEY set

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 retornam `{ "id": "..." }`. Veja o e-mail passar de `queued` para `delivered` na página **E-mails**. Outras linguagens: veja [SDKs](/docs/pt-br/sdks).

## Testes

- `success@simulator.amazonses.com` simula uma entrega sem enviar e-mail a ninguém. Acrescente um rótulo para variar: `success+signup@simulator.amazonses.com`.
- E-mails para o simulador também contam na cota do seu plano.
- `bounce@`, `complaint@` e `suppressionlist@` no simulador geram rejeições e reclamações reais: o endereço entra na sua [lista de supressão](/docs/pt-br/concepts/suppressions) e conta nas suas taxas de rejeição e de reclamação. Use-os à mão, não em testes automatizados. Cada endereço funciona uma vez, então acrescente um rótulo para um novo: `bounce+2@simulator.amazonses.com`.
- Endereços em `example.com`, ou terminados em `.test` ou `.invalid`, não recebem e-mail. Um envio para um deles é recusado com `422` (veja o [Básico da API](/docs/pt-br/api-reference/basics)).

## Próximos passos

- [E-mails](/docs/pt-br/concepts/emails), [Contatos](/docs/pt-br/concepts/contacts) e [Transmissões](/docs/pt-br/concepts/broadcasts).
- [SDKs](/docs/pt-br/sdks) para a sua linguagem.
- [Referência da API](/docs/pt-br/api-reference) com todos os endpoints.
