Deals

Add Deal Touch

Record a touch by hand (a call, a visit). Needs write access to the deal; the person must be on the deal.

post/deals/{deal_id}/touches

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/deals/{deal_id}/touches
  • Auth: HTTP bearer

Path parameters

deal_idstring required

Deal id (UUID).

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

channel'manual'

Only manual touches can be added by hand.

touched_atstring date-time required

When it happened. Not more than a day in the future.

notestring required
emailstring nullable

The deal person it was with; omit for the primary contact. 422 email_not_on_deal otherwise.

Response

Successful Response

dataDealTouchTimelinePayload required

A deal's touch timeline (items, first_touch, last_touch, touch_count) or one added touch.

Changes

No recorded changes to this operation across all 2 revisions of this API.