Create email addresses using API key authentication
The /api/v1/emails/create endpoint allows users to create email addresses programmatically using API key authentication.
You can try the API endpoints in the Email API Playground.
Use your API key in one of two ways:
Authorization Header (Recommended):
LikeDo DocsAuthorization: Bearer YOUR_API_KEYQuery Parameter:
?key=YOUR_API_KEYRate limits are automatically configured based on your subscription tier:
POST /api/v1/emails/create{
"email": "myemail@ig.do",
"tag": "personal"
}| Parameter | Type | Required | Description |
|---|---|---|---|
email | string | Yes | Full email address (4-64 characters for prefix, valid format) |
tag | string | No | Tag for categorization (max 50 characters) |
Access to domains is based on your subscription tier:
ig.do): Available to all userskfc.sh, uv.do): Requires Pro subscription or Lifetime planIf you attempt to use a Pro domain without proper subscription, you'll receive a 403 error.
{
"success": true,
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"email": "myemail@ig.do",
"tag": "personal",
"like": false,
"pin": false,
"createdAt": "2025-12-07T12:00:00.000Z"
}
}{
"success": false,
"error": "Missing API key. Provide it via Authorization header (Bearer token) or ?key= query parameter"
}{
"success": false,
"error": "Invalid or expired API key: [error details]"
}{
"success": false,
"error": "Invalid request data",
"details": [
{
"path": ["email"],
"message": "Invalid email format"
}
]
}{
"success": false,
"error": "Email prefix length must be between 4 and 64 characters"
}{
"success": false,
"error": "The provided email prefix is reserved. Please choose another one."
}{
"success": false,
"error": "You don't have permission to use the domain \"kfc.sh\". Premium domains require an active Pro subscription or Lifetime plan."
}{
"success": false,
"error": "An email address with this address already exists"
}curl -X POST https://your-domain.com/api/v1/emails/create \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"email": "myemail@ig.do",
"tag": "personal"
}'const response = await fetch('https://your-domain.com/api/v1/emails/create', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
email:
import requests
url = 'https://your-domain.com/api/v1/emails/create'
headers = {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
}
data =
.env files or secure vaultsadmin, noreply, postmaster) cannot be used as email prefixes