Fetchply Docs
API reference

Create an email conversation

POST
/api/v1/agents/{id}/email/conversations

Creates an empty conversation without sending. Reuse idempotencyKey on retries; then queue a reply. An active mailboxId or the default sender is used.

Authorization

BearerAuth write:conversations
AuthorizationBearer <token>

In: header

Scope: write:conversations

Path Parameters

id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/v1/agents/string/email/conversations" \  -H "Content-Type: application/json" \  -d '{    "email": "[email protected]",    "subject": "string",    "idempotencyKey": "stringst"  }'
{
  "sessionId": "string"
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "issues": [
    {
      "path": "string",
      "message": "string"
    }
  ]
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "issues": [
    {
      "path": "string",
      "message": "string"
    }
  ]
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "issues": [
    {
      "path": "string",
      "message": "string"
    }
  ]
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "issues": [
    {
      "path": "string",
      "message": "string"
    }
  ]
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "issues": [
    {
      "path": "string",
      "message": "string"
    }
  ]
}

Delete an email mailbox DELETE

Permanently removes a connected address and frees its mailbox allowance. Sending stops, queued emails are cancelled and their allowance is returned, and the address can be connected again. Email history is kept but loses its sender address. Cannot be undone; use the disconnect action for a reversible pause.

Queue a teammate email reply POST

Requires an existing conversation. Reuse idempotencyKey for retries with identical content and recipients. Acceptance is asynchronous; queued is not delivered. Up to 10 To/CC recipients; no BCC. A manual reply pauses AI.