Managed (Cloud)
Self-Hosted
- Welcome to Self Mail Kit
- How to Deploy
API Reference
- API Reference Introduction
- Endpoints
- Email
- Domain
- Audience
- Contact
Endpoints
- Email
- Domain
- Audience
- Contact
Domain
Create domain
Endpoint: v1/domains
Create a new domain for sending emails. The domain name must be in a valid format (e.g., example.com, env.example.com).
curl --request POST \
--url https://api.selfmailkit.com/v1/domains \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"name": "hello.com"
}'
{
"id": "0195ce56-005e-71ee-add6-30d090ced7ed",
"name": "hello.com",
"status": "NOT_STARTED",
"dns_records": [
{
"type": "TXT",
"name": "dkim._domainkey",
"value": "p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQD7mOzhK4x4kXwCdTbF1E4hDqj20f2/HVuFnnYhASOOuHo9Go6AHE14E+sJRW5yOuEFUJLssYKImYCBDtJ2y5SJcR1DxDKyYYiaixCwTqmfB1osXxqESb4BgFC67trrDEzEgQn2K+Hm0Cmzrohfuj4z+ln9wO+wkkt/k02qE6QawQIDAQAB",
"required": true,
"for": "DKIM"
},
{
"type": "MX",
"name": "send",
"value": "feedback-smtp.eu-central-1.amazonses.com",
"priority": 10,
"required": true,
"for": "MAIL FROM domain"
},
{
"type": "TXT",
"name": "send",
"value": "\"v=spf1 include:amazonses.com ~all\"",
"required": true,
"for": "MAIL FROM domain"
},
{
"type": "TXT",
"name": "_dmarc",
"value": "v=DMARC1; p=none;",
"required": false,
"for": "DMARC (highly recommended)"
}
]
}
Authorizations
API key with format "Bearer {your-api-key}"
Body
application/json
Response
200
application/json
Domain successfully created
The response is of type any
.
curl --request POST \
--url https://api.selfmailkit.com/v1/domains \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"name": "hello.com"
}'
{
"id": "0195ce56-005e-71ee-add6-30d090ced7ed",
"name": "hello.com",
"status": "NOT_STARTED",
"dns_records": [
{
"type": "TXT",
"name": "dkim._domainkey",
"value": "p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQD7mOzhK4x4kXwCdTbF1E4hDqj20f2/HVuFnnYhASOOuHo9Go6AHE14E+sJRW5yOuEFUJLssYKImYCBDtJ2y5SJcR1DxDKyYYiaixCwTqmfB1osXxqESb4BgFC67trrDEzEgQn2K+Hm0Cmzrohfuj4z+ln9wO+wkkt/k02qE6QawQIDAQAB",
"required": true,
"for": "DKIM"
},
{
"type": "MX",
"name": "send",
"value": "feedback-smtp.eu-central-1.amazonses.com",
"priority": 10,
"required": true,
"for": "MAIL FROM domain"
},
{
"type": "TXT",
"name": "send",
"value": "\"v=spf1 include:amazonses.com ~all\"",
"required": true,
"for": "MAIL FROM domain"
},
{
"type": "TXT",
"name": "_dmarc",
"value": "v=DMARC1; p=none;",
"required": false,
"for": "DMARC (highly recommended)"
}
]
}
Assistant
Responses are generated using AI and may contain mistakes.