Get Inbound Email

curl -X GET https://win.oneshotagent.com/v1/tools/inbox/email_123 \
  -H "X-Agent-ID: <your_agent_uuid>"

const response = await fetch(
  `https://win.oneshotagent.com/v1/tools/inbox/${emailId}`,
  {
    headers: {
      "X-Agent-ID": agentUuid,
    },
  },
);

{
  "id": "email_123",
  "from": "[email protected]",
  "subject": "Re: Your inquiry",
  "body": "Thanks for reaching out!",
  "body_html": "<p>Thanks for reaching out!</p>",
  "received_at": "2025-12-28T12:00:00Z",
  "thread_id": "thread_abc",
  "attachments": []
}

GET

tools

inbox

{emailId}

curl -X GET https://win.oneshotagent.com/v1/tools/inbox/email_123 \
  -H "X-Agent-ID: <your_agent_uuid>"

const response = await fetch(
  `https://win.oneshotagent.com/v1/tools/inbox/${emailId}`,
  {
    headers: {
      "X-Agent-ID": agentUuid,
    },
  },
);

{
  "id": "email_123",
  "from": "[email protected]",
  "subject": "Re: Your inquiry",
  "body": "Thanks for reaching out!",
  "body_html": "<p>Thanks for reaching out!</p>",
  "received_at": "2025-12-28T12:00:00Z",
  "thread_id": "thread_abc",
  "attachments": []
}

Authentication

Requires X-Agent-ID header with your wallet address. Reads return private, per-agent data, so they are protected by a signed read proof (x-agent-proof header) proving you control that wallet. The OneShot SDK signs and sends this automatically (TypeScript ≥ 0.25.0, Python ≥ 0.17.0). This is rolling out in log-only mode — requests without the proof still succeed today and will be rejected once enforcement is enabled; raw HTTP callers should start sending it. See Read Proof Authentication.

Path Parameters

string

required

The unique identifier of the email to retrieve

Response

string

Email identifier

string

Sender email address

string

Email subject

string

Plain text body

string

HTML body

string

ISO 8601 timestamp

string

Thread identifier

array

Array of attachment objects (same format as list endpoint)

curl -X GET https://win.oneshotagent.com/v1/tools/inbox/email_123 \
  -H "X-Agent-ID: <your_agent_uuid>"

const response = await fetch(
  `https://win.oneshotagent.com/v1/tools/inbox/${emailId}`,
  {
    headers: {
      "X-Agent-ID": agentUuid,
    },
  },
);

{
  "id": "email_123",
  "from": "[email protected]",
  "subject": "Re: Your inquiry",
  "body": "Thanks for reaching out!",
  "body_html": "<p>Thanks for reaching out!</p>",
  "received_at": "2025-12-28T12:00:00Z",
  "thread_id": "thread_abc",
  "attachments": []
}

List Inbound Emails Voice Call

Overview

Email

Email Inbox

Voice

SMS

Commerce

Enrichment

Verification

Research

Build

Notifications

Receipts & Analytics

Other

Compute

Browser

Get Inbound Email

Authentication

Path Parameters

Response

​Authentication

​Path Parameters

​Response

Authentication

Path Parameters

Response