Addresses

List all enhanced email addresses

Changed on

Get an array of enhanced private inbox address objects for the account.

These addresses must be setup ("reserved") using POST /api/addresses/:email, or on the Add Email Address page.

get/addresses

Request

  • Base URL
    https://mailsac.com/api
  • Auth
    • API key in query parameter _mailsacKey
    • or API key in header Mailsac-Key

Response

List of enhanced address objects

_idstring email

the unique identifier of this email address is the email address itself

infostring

Allows setting custom information about this email address.

enabledwsboolean

boolean defaulting false indicating whether to publish messages via web socket when the user owning this inbox is subscribed

forwardstring email

email address where messages to this inbox will be forwarded

webhookstring url

URL where messages to this inbox will be forwarded

webhookSlackstring url

Slack webhook endpoint where messages should be published

webhookSlackToFromboolean

When webhookSlack is set, controls whether the message includes TO and FROM

ownerstring

Account that owns the address (owns the privacy)

encryptedInboxstring email

An alternate email address that will result in the message being delivered to this inbox. This is not always present.

catchAllstring domain

Indicates whether this is a catch-all address, and for which domain.

implicitboolean

When the user owns the domain but has not reserved the address individually, this field is set to true.

createdstring date-time
updatedstring date-time

Example response

[
  {
    "encryptedInbox": "inbox-cf5abefaf492601c5fe0a1563c00b76816145206@mailsac.com"
  }
]

Changes

    • breaking

      the response's body type changed from object to no type, and format from no format to array for status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • info

      api operation id ListAddresses was added

    • info

      api tag Addresses added

    • info

      api tag Email Addresses API removed