Mailactor
API reference

Account & access

Available to every valid tenant key without an additional scope. Returns effective policy metadata but never the key secret, hash, prefix, source fingerprint, or operator data.

Available to every valid tenant API key.

GET/v1/me

Authorization

tenantApiKey
x-api-key<token>

A scoped tenant key returned once by an operator. Never place it in URLs, logs, prompts, or client-side application code.

In: header

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

# Set the API key and replace resource IDs with your saved IDs.curl --fail-with-body --silent --show-error -X GET \  "https://api.mailactor.com/v1/me" \  -H "x-api-key: $MAILACTOR_API_KEY"

Response examples

Illustrative values; save the IDs and limits returned by your own requests.

HTTP 200

{
  "organization": {
    "id": "00000000-0000-4000-8000-000000000003",
    "status": "active",
    "sendLimits": {
      "messagesPerMinute": 10,
      "messagesPerDay": 100,
      "recipientsPerDay": 100
    }
  },
  "apiKey": {
    "id": "00000000-0000-4000-8000-000000000004",
    "kind": "agent",
    "scopes": [
      "mailbox:manage",
      "mailbox:read",
      "mailbox:send",
      "delivery:read",
      "webhook:manage"
    ],
    "inboxIds": null,
    "allowedIps": null,
    "sendMode": "new_and_reply",
    "allowedRecipientDomains": null,
    "expiresAt": null,
    "requestsPerMinute": 60
  },
  "managedStarter": {
    "limit": 10,
    "used": 0,
    "remaining": 10
  },
  "platformLimits": {
    "recipientsPerMessage": 10,
    "messageContentBytes": 1000000,
    "inboxes": 10,
    "domains": 5,
    "webhookEndpoints": 5
  }
}