Skip to content
Kirim.Email SMTP API

Getting Your API Token

Overview

Section titled “Overview”

To use the Kirim.Email SMTP API, you need an API token. The token authenticates your requests and is used alongside your username for Basic Authentication.

You can manage your tokens from the Tokens page in the Kirim.Email dashboard.

Finding the Tokens Page

Section titled “Finding the Tokens Page”

There are two ways to access the Tokens page:

Profile Dropdown

Click your profile avatar or name at the bottom left of the sidebar, then select Tokens from the dropdown menu.

Creating a Token

Section titled “Creating a Token”

  1. Navigate to the Tokens page.

  2. Click the Create Token button.

  3. Copy the generated token immediately — it is shown only once and cannot be retrieved later.

  4. Store the token securely, for example in a password manager or environment variable.

Using Your Token

Section titled “Using Your Token”

The token is used as the password in Basic Authentication:

Terminal window
curl -X GET "https://smtp-app.kirim.email/api/domains" \
  -u "username:your-api-token"

Replace username with your Kirim.Email username and your-api-token with the token you created.

Section titled “Environment Variable (Recommended)”

Store your token in an environment variable to keep it secure:

Terminal window
export KIRIMEMAIL_API_TOKEN="your-api-token"


curl -X GET "https://smtp-app.kirim.email/api/domains" \
  -u "username:$KIRIMEMAIL_API_TOKEN"

Managing Tokens

Section titled “Managing Tokens”
Action Description
View Tokens See all active tokens with their creation date and last used timestamp.
Create Token Generate a new API token.
Delete Token Revoke a token immediately. Any requests using a deleted token will be rejected.

Next Steps

Section titled “Next Steps”