---
title: "New Email"
method: POST
path: "/NEW_EMAIL"
tags: ["Agent Activity"]
---

# New Email

`POST /NEW_EMAIL`

## Request

- Base URL: `https://apidocs.goaugment.com` (the document declares no server; this is the origin it was published from)
- URL: `https://apidocs.goaugment.com/NEW_EMAIL`
- Auth: none declared
- TypeScript: <https://skmtc.dev/goaugment/apis/webhooks/docs/NEW_EMAIL/post.ts> (a function with typed inputs; its response is checked against the schema)

> v1 equivalent: none. v2 only.

Sent when an inbound email relating to one of your loads is received by an Augment agent. `participants` and `subject` identify the email, while `summary` and `classification` describe what it was about.

## Request body

- NewEmailEvent: Fields present on every v2 webhook event.
  - `id` string, required: Unique event identifier (ULID)
  - `workflow` 'TRACK_AND_TRACE' | 'CARRIER_SUPPORT' | 'POD_COLLECTION' | 'LOAD_BUILDING' | 'CARRIER_SELECTION' | 'SCHEDULING' | 'CUSTOMER_SUPPORT' | 'null', nullable, required: The Augment workflow that produced this event, or `null` when no single workflow can be attributed. New values may be added over time, so treat this as an open set rather than a fixed list.
  - `occurredAt` string, date-time, required: When the underlying activity occurred (ISO 8601)
  - `loadNumber` string, nullable, required: Your load reference number
  - `customerLoadInternalId` string, nullable, required: Your internal load ID, if provided during load creation
  - `eventType` 'NEW_EMAIL', required: Event name for a received email.
  - `data` EmailData, required: An email an Augment agent sent or received on this load. `summary` and `classification` accompany inbound email.
    - `direction` 'INBOUND' | 'OUTBOUND', required: Direction of the communication from Augment's point of view. `OUTBOUND` means Augment initiated it; `INBOUND` means Augment received it.
    - `attachmentCount` integer, required: Number of attachments on the email.
    - `participants` EmailParticipants, required: Sender and recipients of the email.
      - `from` EmailParticipant, required: A sender or recipient on an email.
        - `name` string, required: Display name, empty when the email carried only an address.
        - `address` string, required: Email address
      - `to` EmailParticipant[], required: Direct recipients.
        - `name` string, required: Display name, empty when the email carried only an address.
        - `address` string, required: Email address
      - `cc` EmailParticipant[], required: Copied recipients. Empty array when there were none.
        - `name` string, required: Display name, empty when the email carried only an address.
        - `address` string, required: Email address
    - `subject` string: Subject line.
    - `summary` string: Plain-language summary of the email. Inbound email only.
    - `classification` string: The category Augment assigned to the email. Inbound email only. Treat as an open set — classifications are added over time.

## Response `200`

Event acknowledged

---

[API](https://skmtc.dev/goaugment/apis/webhooks.md) - [All operations](https://skmtc.dev/goaugment/apis/webhooks/llms.txt) - [OpenAPI document](https://skmtc.dev/goaugment/apis/webhooks/revisions/a074b2ada419?raw)