Docs
Setup API Keys

Setup API Keys

Setting up API keys to send emails.

Go to the API Keys page and create your API key by following these steps:

Steps:

Sign up/ Login to your WeSend account

API Key Navigation

Create a new API Key by clicking on "Add Mail Server"

Fill in the details for your key

Add API key details

If you have not configured any mail servers yet, refer to Setup Mail Servers.

Done!

You can now send emails from the configured SMTP Server!

Key format

Keys created by current versions of WeSend look like this:

fsk_live_9f2a7c41b8e35d06a1c9f4e72b8d5a30

The fsk_live_ prefix makes a key recognisable at a glance in logs, config files and pull requests, and lets secret scanners match on it. After the prefix are 32 hexadecimal characters carrying 128 bits of randomness from the operating system's cryptographic random source.

Keys issued before this format existed are bare UUIDs, and they keep working. WeSend authenticates by comparing the key to the stored value exactly and never inspects its shape, so there is nothing to migrate. If you would rather move to the new format, create a new key and delete the old one.

Treat the whole string as the secret. Store it in an environment variable rather than in source control, and rotate it by creating a replacement key and deleting the old one.

Next Steps