Getting started

<Steps> ### Get your API key Generate an API key from your Resent account. You'll need it to authenticate every request — copy it immediately, it's only shown once. <Button href="https://resent.one/app/settings/api-keys/" intent="primary" target="_blank"> Open API key settings → </Button> In the **API keys** tab, click **Generate a new API key**, name it, and save it somewhere secure. ### Whitelist your IP address The playground runs from your browser, so Resent needs to recognize your current IP before processing requests from it. Your current IP address is: <div class="resent-ip-box"><code id="resent-client-ip">Detecting…</code></div> Add it to the **Authorized IPs** list in [IP whitelisting](https://resent.one/app/settings/ip-whitelisting/). <Button href="https://resent.one/app/settings/ip-whitelisting/" intent="primary" target="_blank"> Open IP whitelisting → </Button> <Tip> Prefer to skip this step? Send your first request anyway. If your IP isn't whitelisted, Resent sends a security email with a one-click authorization link — then come back and retry. Not required when calling the API from a server or CLI. </Tip> ### Send your first request Enter your API key in the `Authorization` header in the panel on the right, then click **Send request**. A `200` response with your account details confirms your key is valid — you're ready to build. </Steps> ## What's next - [Authentication](/authentication) — Bearer API key auth and required headers - [Send transactional emails](/guides/send-transactional-email) — send your first message - [Add a domain](/guides/add-a-domain) — verify SPF/DKIM before mailing third parties - [Setup webhooks](/webhooks) — receive delivery, open, and WhatsApp events - [Rate limits](/rate-limits) — understand quotas and `429` handling ## Tools and resources <CardGroup cols={3}> <Card title="Dashboard" icon="fa-duotone fa-grid-2" href="https://resent.one/app"> Create keys, verify domains, and send from the Resent dashboard. </Card> <Card title="API Rate limits" icon="fa-duotone fa-gauge-high" href="/rate-limits"> Optimize for throughput and handle rate-limit responses. </Card> <Card title="MCP Server" icon="fa-duotone fa-robot" href="/mcp"> Integrate Resent docs with AI assistants via Model Context Protocol. </Card> </CardGroup>

Authentication

AuthorizationBearer

Your Resent API key (re_xxxxxxxxx)

Response

Account details
emailstring
Primary account email.
companyNamestring
planstring
Current plan name.
relayobject

Errors

401
Unauthorized Error
404
Not Found Error