Email Logs

The email_log object

A record of an email sent on the account's behalf, such as an invoice or a user invitation.

idstring

Email log ID.

objectstringenumValues:email_log

Resource type identifier.

send_statusstringenumValues:sentpending

Email send status.

pending: the email is queued and has not been sent yet.
sent: the email has been handed off for delivery.

recipientsarray of string

Recipient email addresses.

subjectstringnullable

Email subject line.

filenamestringnullable

Filename of the attached document.

sent_byactornullable

The user who sent the email.

Absent for emails the platform sends automatically (for example system notifications), which are not attributed to a user.

idstring

Unique identifier of the actor.

objectstringenumValues:actor

Resource type identifier.

typestringenumValues:userapi_keyagent

Actor type.

user: a human user account.
api_key: a programmatic caller authenticating with an API key.
agent: an automated agent acting on the account's behalf.
group: a shared group identity, such as a "Customer Service" persona, rather than a single individual.

namestringnullable

The actor's display name.

handlestringnullable

Human-readable handle identifying the actor.

For user actors: the user's email address.
For api_key actors: the redacted key value.

Other actor types carry no handle.

avatar_urlstringnullable

URL of the actor's profile photo, if one is set.

Only populated for user actors.

rolerolenullable

Assigned role.

Always returned as null in this endpoint.

created_atstring (date-time)

Creation timestamp.

updated_atstring (date-time)

Last updated timestamp.

Used by

GETList Email LogsEmail Logs GETRetrieve Email LogEmail Logs

email_log example

{
  "id": "eml_017b80707ada92dddff8a2c3a0",
  "object": "email_log",
  "send_status": "sent",
  "recipients": [
    "customer@example.com"
  ],
  "subject": "Order Confirmation #1001",
  "filename": "invoice_1001.pdf",
  "sent_by": {
    "id": "us_0151164dcaea4cbded27b50aae",
    "object": "actor",
    "type": "user",
    "name": "John Doe",
    "handle": "jdoe@augno.com",
    "avatar_url": "https://cdn.augno.com/avatars/us_0151164dcaea4cbded27b50aae.jpg",
    "role": {
      "id": "rl_01c16d2eb637c0d1f3a372937c",
      "object": "role",
      "name": "Admin",
      "type": "admin",
      "owner": {
        "object": "owner",
        "type": "account",
        "account": {
          "id": "ac_01148680966698341a9c0976db",
          "object": "account",
          "name": "Acme Inc.",
          "default_billing_address": null,
          "default_shipping_address": null,
          "branding": null,
          "portal": null,
          "created_at": "2026-05-10T00:00:00Z",
          "updated_at": "2026-05-10T00:23:00Z"
        }
      },
      "permissions": [
        "customers:create",
        "customers:read",
        "customers:update",
        "customers:delete"
      ],
      "created_at": "2026-05-10T00:00:00Z",
      "updated_at": "2026-05-10T00:23:00Z"
    }
  },
  "created_at": "2026-05-10T00:00:00Z",
  "updated_at": "2026-05-10T00:23:00Z"
}

{
  "id": "eml_017b80707ada92dddff8a2c3a0",
  "object": "email_log",
  "send_status": "sent",
  "recipients": [
    "customer@example.com"
  ],
  "subject": "Order Confirmation #1001",
  "filename": "invoice_1001.pdf",
  "sent_by": {
    "id": "us_0151164dcaea4cbded27b50aae",
    "object": "actor",
    "type": "user",
    "name": "John Doe",
    "handle": "jdoe@augno.com",
    "avatar_url": "https://cdn.augno.com/avatars/us_0151164dcaea4cbded27b50aae.jpg",
    "role": {
      "id": "rl_01c16d2eb637c0d1f3a372937c",
      "object": "role",
      "name": "Admin",
      "type": "admin",
      "owner": {
        "object": "owner",
        "type": "account",
        "account": {
          "id": "ac_01148680966698341a9c0976db",
          "object": "account",
          "name": "Acme Inc.",
          "default_billing_address": null,
          "default_shipping_address": null,
          "branding": null,
          "portal": null,
          "created_at": "2026-05-10T00:00:00Z",
          "updated_at": "2026-05-10T00:23:00Z"
        }
      },
      "permissions": [
        "customers:create",
        "customers:read",
        "customers:update",
        "customers:delete"
      ],
      "created_at": "2026-05-10T00:00:00Z",
      "updated_at": "2026-05-10T00:23:00Z"
    }
  },
  "created_at": "2026-05-10T00:00:00Z",
  "updated_at": "2026-05-10T00:23:00Z"
}

Email Logs

Attributes

Used by