Fetchply Docs
API reference

Delete an email mailbox

DELETE
/api/v1/agents/{id}/email

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.

Authorization

BearerAuth write:email
AuthorizationBearer <token>

In: header

Scope: write:email

Path Parameters

id*string

Query Parameters

mailboxId*string

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/api/v1/agents/string/email?mailboxId=string"
{
  "mailboxes": [
    {
      "id": "string",
      "chatbotId": "string",
      "domainId": "string",
      "address": "string",
      "receivingMode": "forwarding",
      "name": "string",
      "status": "pending",
      "isDefault": true,
      "aiEnabled": true,
      "instructions": "string",
      "signature": "string",
      "toolAllowlist": [
        "string"
      ],
      "receivingVerifiedAt": "2019-08-24T14:15:22Z",
      "lastReceivedAt": "2019-08-24T14:15:22Z",
      "testSentAt": "2019-08-24T14:15:22Z",
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z"
    }
  ],
  "allowance": {
    "maxMailboxes": 0,
    "monthlyRecipients": 0,
    "scope": "string",
    "period": "string",
    "used": 0
  },
  "tools": [
    {
      "name": "string",
      "title": "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.

Create an email conversation POST

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