Enable Inbound

curl --request POST \
  --url https://api.autosend.com/v1/domains/60d5ec49f1b2c72d9c8b1111/inbound/enable \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.autosend.com/v1/domains/60d5ec49f1b2c72d9c8b1111/inbound/enable"

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.json())

const response = await fetch(
  "https://api.autosend.com/v1/domains/60d5ec49f1b2c72d9c8b1111/inbound/enable",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer <token>",
    },
  }
);

const data = await response.json();
console.log(data);

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.autosend.com/v1/domains/60d5ec49f1b2c72d9c8b1111/inbound/enable",
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
  ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;

package main

import (
  "fmt"
  "io"
  "net/http"
)

func main() {
  req, _ := http.NewRequest("POST", "https://api.autosend.com/v1/domains/60d5ec49f1b2c72d9c8b1111/inbound/enable", nil)
  req.Header.Set("Authorization", "Bearer <token>")

  client := &http.Client{}
  resp, _ := client.Do(req)
  defer resp.Body.Close()

  body, _ := io.ReadAll(resp.Body)
  fmt.Println(string(body))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.autosend.com/v1/domains/60d5ec49f1b2c72d9c8b1111/inbound/enable"))
    .header("Authorization", "Bearer <token>")
    .POST(HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

require "net/http"
require "uri"

uri = URI.parse("https://api.autosend.com/v1/domains/60d5ec49f1b2c72d9c8b1111/inbound/enable")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Post.new(uri.request_uri)
request["Authorization"] = "Bearer <token>"

response = http.request(request)
puts response.body

{
  "success": true,
  "data": {
    "id": "60d5ec49f1b2c72d9c8b1111",
    "domainName": "example.com",
    "verificationStatus": "VERIFIED",
    "dnsRecords": {
      "inboundMx": {
        "name": "example.com",
        "value": "inbound-smtp.us-east-1.amazonaws.com",
        "type": "MX",
        "purpose": "inbound",
        "priority": 10
      }
    },
    "createdAt": "2026-01-05T10:00:00.000Z",
    "lastCheckedAt": "2026-03-10T14:20:00.000Z",
    "verifiedAt": "2026-01-05T12:00:00.000Z",
    "regionKey": "us-east-1",
    "inboundEnabledAt": "2026-03-10T14:25:00.000Z",
    "inboundDomainVerifiedAt": null
  }
}

Enable inbound email receiving on a custom domain that has already been verified. Calling this endpoint stamps the domain as inbound-enabled and returns the inbound MX record you must publish in your DNS. Once that MX record is detected in DNS during the next verification check, inbound emails becomes live for the domain (at which point inboundDomainVerifiedAt is set).

Authorizations

string | header

required

Bearer authentication header of the form Bearer <token>, where <token> is your API key.

Path Parameters

string

required

The id of the domain on which to enable inbound receiving.

Response

boolean

Indicates whether the request was successful.

object

The updated domain object.

Show Domain object

string

Unique identifier for the domain (id).

string

The domain name (e.g. example.com).

string

Overall domain verification status. One of PENDING_CONFIGURATION, PENDING, or VERIFIED.

object

DNS records for the domain. After enabling inbound, this includes the inboundMx record you must publish.

Show DNS Records object

object

The MX record to publish so AutoSend can receive mail for this domain. Contains name, value, type, purpose, and priority fields.

string

ISO 8601 timestamp of when the domain was added.

string

ISO 8601 timestamp of the last DNS verification check.

string

ISO 8601 timestamp of when the domain was verified. Only present for verified domains.

string

The AutoSend region key where the domain is configured (e.g. us-east-1).

string

ISO 8601 timestamp of when inbound receiving was enabled on the domain.

string

ISO 8601 timestamp of when the inbound MX record was detected i.e inbound is verified and live. null until the MX record is detected in DNS.

Errors

object

Returned when no domain with the given domainId exists in the project.

object

Returned when inbound receiving could not be enabled on the domain.

curl --request POST \
  --url https://api.autosend.com/v1/domains/60d5ec49f1b2c72d9c8b1111/inbound/enable \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.autosend.com/v1/domains/60d5ec49f1b2c72d9c8b1111/inbound/enable"

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.json())

const response = await fetch(
  "https://api.autosend.com/v1/domains/60d5ec49f1b2c72d9c8b1111/inbound/enable",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer <token>",
    },
  }
);

const data = await response.json();
console.log(data);

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.autosend.com/v1/domains/60d5ec49f1b2c72d9c8b1111/inbound/enable",
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
  ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;

package main

import (
  "fmt"
  "io"
  "net/http"
)

func main() {
  req, _ := http.NewRequest("POST", "https://api.autosend.com/v1/domains/60d5ec49f1b2c72d9c8b1111/inbound/enable", nil)
  req.Header.Set("Authorization", "Bearer <token>")

  client := &http.Client{}
  resp, _ := client.Do(req)
  defer resp.Body.Close()

  body, _ := io.ReadAll(resp.Body)
  fmt.Println(string(body))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.autosend.com/v1/domains/60d5ec49f1b2c72d9c8b1111/inbound/enable"))
    .header("Authorization", "Bearer <token>")
    .POST(HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

require "net/http"
require "uri"

uri = URI.parse("https://api.autosend.com/v1/domains/60d5ec49f1b2c72d9c8b1111/inbound/enable")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Post.new(uri.request_uri)
request["Authorization"] = "Bearer <token>"

response = http.request(request)
puts response.body

{
  "success": true,
  "data": {
    "id": "60d5ec49f1b2c72d9c8b1111",
    "domainName": "example.com",
    "verificationStatus": "VERIFIED",
    "dnsRecords": {
      "inboundMx": {
        "name": "example.com",
        "value": "inbound-smtp.us-east-1.amazonaws.com",
        "type": "MX",
        "purpose": "inbound",
        "priority": 10
      }
    },
    "createdAt": "2026-01-05T10:00:00.000Z",
    "lastCheckedAt": "2026-03-10T14:20:00.000Z",
    "verifiedAt": "2026-01-05T12:00:00.000Z",
    "regionKey": "us-east-1",
    "inboundEnabledAt": "2026-03-10T14:25:00.000Z",
    "inboundDomainVerifiedAt": null
  }
}

API Reference

Sending

Contacts

Contact Properties

Templates

Senders

Campaigns

Automations

Events

Domains

Contact Lists

Suppression Groups

Projects

Webhooks

Inbound Emails

Custom Fields

Authorizations

Path Parameters

Response

Errors

​Authorizations

​Path Parameters

​Response

​Errors

Authorizations

Path Parameters

Response

Errors