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"
    }
  ]
}

Manage an email mailbox POST

Connect an owned business address, check DNS, test forwarding/sending, activate, update settings, disconnect or reconnect. Setup tests send real emails. Automatic replies default off.

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.