Skip to main content
PATCH
/
api
/
email
/
accounts
/
{id}
Update an email sender account
curl --request PATCH \
  --url https://app.puffle.ai/api/email/accounts/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "signature": "<string>"
}
'
{
  "account": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "type": "email",
    "domain_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "email_address": "[email protected]",
    "agentmail_inbox_id": "<string>",
    "instantly_account_id": "<string>",
    "status": "pending",
    "warmup_status": "not_started",
    "display_name": "<string>",
    "first_name": "<string>",
    "last_name": "<string>",
    "signature": "<string>",
    "instantly_tag_id": "<string>",
    "instantly_warmup_tag_id": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "email_domains": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "domain": "<string>",
      "status": "pending"
    }
  }
}

​
Overview

Update mutable fields on an email sender account. Signature changes are synced to Instantly first; if that sync fails, the DB is not updated and a 502 is returned so callers can retry without drift.
This operation shares the URL path /api/email/accounts/{id} with other verbs. See the sibling page for related operations on the same resource.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string<uuid>
required

Email account (accounts.id) UUID.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Body

application/json

Currently only signature is mutable. Other account fields (email address, warmup status, etc.) are system-managed.

​
signature
string

Per-account email signature. Newlines are converted to <br> when synced to Instantly. Passing "" clears the signature (Instantly receives a single space so the field isn't ignored).

Response

Account updated. Returns the full account row.

​
account
object
required

An AgentMail-backed email sending inbox. Each account row maps 1:1 to exactly one AgentMail inbox and (optionally) one Instantly warmup account.