Skip to main content
GET
/
api
/
v1
/
inbox
Get Inboxes
curl --request GET \
  --url https://app.botmailroom.com/api/v1/inbox \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "<string>",
    "name": "<string>",
    "email_address": "<string>",
    "allow_cc": true,
    "allow_bcc": true,
    "spf_pass_required": true,
    "dkim_pass_required": true,
    "dmarc_pass_required": true,
    "allowed_from_addresses": {
      "addresses": [
        "<string>"
      ],
      "domains": [
        "<string>"
      ]
    },
    "blocked_from_addresses": {
      "addresses": [
        "<string>"
      ],
      "domains": [
        "<string>"
      ]
    },
    "webhook_url": "<string>",
    "webhook_authentication_type": "signing_secret",
    "open_and_click_tracking": false,
    "updated_at": "<string>",
    "webhook_secret_preview": "<string>"
  }
]

Authorizations

​
Authorization
string
header
required

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

Response

Successful Response

​
id
string
required
​
name
string
required
​
email_address
string
required
​
updated_at
string
required

UTC, ISO 8601 format

​
allow_cc
boolean
default:true

If true, emails that contain the inbox email address in the Cc field will be marked valid

​
allow_bcc
boolean
default:true

If true, emails that contain the inbox email address in the Bcc field will be marked valid

​
spf_pass_required
boolean
default:true

If true, emails need to pass the SPF check to be marked valid. See here for more information on SPF

​
dkim_pass_required
boolean
default:true

If true, emails need to pass the DKIM check to be marked valid. See here for more information on DKIM

​
dmarc_pass_required
boolean
default:true

If true, emails need to pass the DMARC check to be marked valid. See here for more information on DMARC

​
allowed_from_addresses
object | null

A list of addresses and domains that are allowed to send emails to the inbox. If the field is null, or the addresses and domains fields are both empty lists, all from addresses are allowed

​
blocked_from_addresses
object | null

A list of addresses and domains that are blocked from sending emails to the inbox. If the field is null, or the addresses and domains fields are both empty lists, all from addresses are allowed

​
webhook_url
string | null

The url to send webhooks to when an email is received by the inbox

​
webhook_authentication_type
enum<string> | null

The type of authentication to use for the webhook. Must be provided if webhook_url is provided. See here for more information

Available options:
signing_secret,
bearer_token
​
open_and_click_tracking
boolean
default:false

If true, open and click tracking will be enabled for all emails sent from the inbox

​
webhook_secret_preview
string | null