Search Deal Touches
POST /deals/{deal_id}/touches/search
POST
/deals/{deal_id}/touches/search
Propose touches from the deal owner’s Sent mail. WRITES NOTHING; accept records the ones you pick.
Personal key only: the search reads the OWNER’s mailbox, so the caller must be the deal owner or an org admin
(an admin’s search of someone else’s mailbox is audit-logged). 409 deal_touch_disabled /
deal_touch_sent_capture_disabled while the organisation has not turned capture on.
Authorizations
Parameters
Path Parameters
deal_id
required
Deal id (UUID).
string
Deal id (UUID).
Header Parameters
Responses
200
Successful Response
object
data
required
Candidate touches found in the deal owner’s Sent mail (candidates), each with a short-lived token.
object
key
additional properties
any
pagination
Any of:
object
has_next
required
Whether there are more pages
boolean
limit
required
Items per page
integer
notes
Any of:
Array<string>
null
page
required
Current page number (1-indexed)
integer
total
required
Total number of items
integer
null
422
Validation Error
object
detail
Array<object>
object
loc
required
Array
msg
required
string
type
required
string