coss.comdocs

Retrieve the environment's inbound address

GET
/v1/received_emails/address

The environment's own domain under COSS's inbound domain: email sent to any address at it (e.g. support@<domain>) is received by this environment, with no DNS setup. To receive at your own domain, add a receiving domain instead.

Authorization

bearerAuth
headerAuthorizationBearer <token>

A secret API key from the dashboard: coss_live_… for production environments, coss_test_… for sandbox environments.

Header Parameters

Coss-Version?"2026-10-10"

The API version (a date) to use for this request. Defaults to your organization's version, pinned to the latest one when it first used the API and upgraded from the dashboard. The SDK always sends the version it was built for.

Value in"2026-10-10"

Response Body

The environment's inbound address.

application/json
  1. response
object*"inbound_address"
Value in"inbound_address"
environment_id*string
domain*string

Email sent to any address at this domain is received by the environment, with no DNS setup. It never changes.

import { Coss } from "coss";const coss = new Coss({  apiKey: process.env.COSS_API_KEY,  baseUrl: "https://api.coss.com",});const { data, error } = await coss.email.received.address();
{  "object": "inbound_address",  "environment_id": "env_01k7c8m4q2f3e9v6t5r1n0p8yz",  "domain": "k3j9x2m7qp4l.inbound.coss.com"}