Inbound addresses Live

Inbound addresses are the email addresses that, when emailed, become tickets in your workspace. Three flavours: an auto-generated address per workspace, custom localparts on our shared subdomain, or addresses on your own custom domain.

Address kinds

List addresses

All addresses configured in the workspace.

Code samples

curl 'https://app.message.com/api/v1/inbound-addresses' \
  -H 'Authorization: Bearer YOUR_WORKSPACE_JWT'

const res = await fetch('https://app.message.com/api/v1/inbound-addresses', {
  headers: { Authorization: 'Bearer ' + token }
});
const { addresses } = await res.json();

import requests
r = requests.get(
    "https://app.message.com/api/v1/inbound-addresses",
    headers={"Authorization": f"Bearer {token}"},
)
addresses = r.json()["addresses"]

require "net/http"
require "json"
uri = URI("https://app.message.com/api/v1/inbound-addresses")
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
  req = Net::HTTP::Get.new(uri)
  req["Authorization"] = "Bearer #{token}"
  http.request(req)
end
addresses = JSON.parse(res.body)["addresses"]

<?php
$ctx = stream_context_create([
  "http" => ["method" => "GET", "header" => "Authorization: Bearer $token"]
]);
$addresses = json_decode(file_get_contents("https://app.message.com/api/v1/inbound-addresses", false, $ctx), true)["addresses"];

Create an address

{
  "kind": "subdomain",
  "localPart": "support",
  "departmentId": "uuid"
}

{
  "id": "uuid",
  "kind": "subdomain",
  "address": "[email protected]",
  "departmentId": "uuid",
  "verified": true,
  "createdAt": "2026-05-13T15:30:00Z"
}

Update routing

Change the department, or update the local-part on a subdomain address. The address string regenerates accordingly.

Delete an address

Mail to a deleted address bounces with a permanent failure. Existing tickets stay in the inbox.

Sending a test email

The fastest way to verify routing is to email the address from your phone. The inbound webhook fires within a few seconds; check Settings → Logs for the trace if nothing arrives. Most failures are SPF or DMARC misconfiguration on the sending side.

Errors

Common pitfalls

• Using a free email provider for the local-part on a custom domain. Forwarding from Gmail to message.com works; using a Gmail address as your inbound address does not. You need a domain you control.
• Forgetting SPF / DKIM / DMARC. Custom-domain inbound needs working DNS. The dashboard surfaces a checklist; verify all three are green.
• Routing to a deleted department. The inbound webhook will still create a ticket but it lands in the workspace queue, not a specific dept.