API Reference

Create a deal event

post
https://api.heymantle.com/v1/deals//events

Create a new event for a deal. If a dealStageId is provided, the deal will be progressed to that stage. If a dealActivityId is provided and that activity is configured for a future stage, the deal will automatically progress to that stage. This replicates the behavior of the application's deal progression logic.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The ID of the deal

Body Params
string

Name of the custom activity

string

Notes or description for the event

string

ID of the associated deal activity. If provided and the activity is configured for a future stage, the deal will automatically progress to that stage.

string

ID of the stage to progress the deal to. When provided, the deal will be updated to this stage and a progression event will be created.

string

ID of the associated task

string

ID of the associated app event

date-time

When the event occurred (defaults to now)

string

ID of the user who created the event (defaults to authenticated user)

Responses

400

Invalid request (e.g., invalid stage or activity).

404

Deal not found.

Updated 6 months ago

Language
Credentials
OAuth2
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 6 months ago