Creating Email Addresses

The Email API allows you to create custom email addresses on your A1Base account. Get started with our free domains @a101.bot or @a1send.com.

Request Parameters

Parameter	Type	Required	Description
`address`	string	Yes	The local part of the email address (before the @ symbol)
`domain_name`	string	Yes	The domain name to use for the email address

Endpoint

curl --location 'https://api.a1base.com/v1/emails/{account_id}/create-email' \
--header 'X-API-Key: YOUR_API_KEY' \
--header 'X-API-Secret: YOUR_API_SECRET' \
--header 'Content-Type: application/json' \
--data '{
    "address": "jane",
    "domain_name": "a1send.com"
}'

Valid Email Addresses:

5-30 characters long
Only contain letters, numbers, ’.’, ’_’, ’-’
Have no consecutive dots, spaces, or commas

Example Response

{
    "status": "success",
}

Error Responses

Status Code	Description
400	Invalid request parameters
401	Invalid API credentials
403	Domain not authorized for account
409	Email address already exists

Next Steps

After creating your email address, you can:

Set up a webhook to receive incoming emails
Send emails from your new address
Configure a custom domain for your email addresses

We’d love to hear from you!Don’t hesitate to reach out to [email protected] or [email protected] if there’s any features you’d like to see or prioritised!

Quickstart Receiving Emails

A1Mail

Email API

Custom Mail Domain

Creating Email Addresses

Request Parameters

Endpoint

Example Response

Error Responses

Next Steps

​Request Parameters

​Endpoint

​Example Response

​Error Responses

​Next Steps

Request Parameters

Endpoint

Example Response

Error Responses

Next Steps