---
title: "Put an email in a box"
method: PUT
path: "/boxes/{key}/threads"
---

# Put an email in a box

`PUT /boxes/{key}/threads`

## Request

- Base URL: `https://api.streak.com/api/v1`
- URL: `https://api.streak.com/api/v1/boxes/{key}/threads`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/streakyc/apis/streak-v1-url-encoded/docs/boxes/:key/threads/put.ts> (a function with typed inputs; its response is checked against the schema)

See [here](reference#threads) for more information on threads.

## Path parameters

- `key` string, required

## Request body `application/x-www-form-urlencoded`

- object
  - `boxKey` string, required: Box key
  - `threadGmailId` string, required: The Gmail thread you'd like to add to the box (eg `15d52837dc00ff8e`). **Important**: Gmail assigns each user their own unique thread ID, even if they are included in the same email conversation. When calling this endpoint, the `threadGmailId` value you provide must belong to the user whose API key you are using.

## Response `200`

200

- object[]
  - `creatorKey` string
  - `boxKey` string
  - `pipelineKey` string
  - `creationTimestamp` integer
  - `lastUpdatedTimestamp` integer
  - `numberOfEmails` integer
  - `names` unknown[]
    - unknown
  - `emailAddresses` unknown[]
    - unknown
  - `threadGmailId` string
  - `fileKeys` unknown[]
    - unknown
  - `gmailThreadKey` string
  - `key` string
  - `lastSavedTimestamp` integer

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `467f4c2b40e3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/streakyc/apis/streak-v1-url-encoded/changes/boxes/:key/threads/put.md)

---

[API](https://skmtc.dev/streakyc/apis/streak-v1-url-encoded.md) - [All operations](https://skmtc.dev/streakyc/apis/streak-v1-url-encoded/llms.txt) - [OpenAPI document](https://skmtc.dev/streakyc/apis/streak-v1-url-encoded/revisions/467f4c2b40e3?raw)