Monitor an existing conversation and create a draft

This is a two-step write workflow. It works only with an already-sent conversation. It does not send cold emails or transmit drafts automatically.

Requirements

• A connected mailbox in Draft mode.
• A REST developer key with nudge.mailboxes.read, nudge.conversations.read, nudge.conversations.write and nudge.drafts.write.
• A valid mailbox ID and provider thread ID returned by conversation search.
• A unique idempotency key for each write.

Find an existing conversation

curl -G "https://app.nudgeforme.com/api/v1/conversations" \
  -H "Authorization: Bearer YOUR_KEY" \
  --data-urlencode "mailboxId=MAILBOX_ID" \
  --data-urlencode "search=invoice"

Add that conversation to monitoring

curl -X POST "https://app.nudgeforme.com/api/v1/conversations/watch" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: watch-invoice-20261110" \
  -d '{"mailboxId":"MAILBOX_ID","providerThreadId":"PROVIDER_THREAD_ID"}'

Use the returned Nudge watched threadId for subsequent operations. Do not assume the provider thread ID is the same as Nudge's thread ID.

Generate one draft

curl -X POST "https://app.nudgeforme.com/api/v1/drafts" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: draft-invoice-20261110" \
  -d '{"threadId":"NUDGE_THREAD_ID","research":false}'

Review the draft inside Gmail/Outlook or Nudge's supported workflow before sending manually.

Check the result

curl -G "https://app.nudgeforme.com/api/v1/followups/status" \
  -H "Authorization: Bearer YOUR_KEY" \
  --data-urlencode "threadId=NUDGE_THREAD_ID"

Avoid duplicate operations

Each new POST should use its own stable key. On a network timeout, check status first; don't automatically use a new key or you might repeat an operation whose result was unknown. Do not loop over all opportunities to generate drafts without explicit user approval.

If a mailbox is configured to auto-send, external watch/draft operations should be rejected. Change the mailbox to Draft mode inside Nudge before retrying.