Skip to main content
POST
Create deal

Body

contactId
integer<int32> | null

ID of an existing contact to link to this deal.

Example:

42

stage
string | null

The deal pipeline stage name.

Example:

"Qualified"

closeDate
string<date-time> | null

Expected close date of the deal.

Example:

"2025-12-31T00:00:00Z"

properties
object | null

Dictionary of custom deal properties defined in your Kiflo account.

Example:
partners
object[] | null

List of partner roles on the deal.

contact
object

Inline contact to create and associate with the deal.

source
enum<string>
Available options:
Unknown,
Website,
Partner,
Api,
Zapier,
Tenant,
System,
HubSpot,
Stripe,
PartnerDirectory
contractStartDate
string<date-time> | null

Contract start date.

Example:

"2025-01-01T00:00:00Z"

contractEndDate
string<date-time> | null

Contract end date.

Example:

"2025-12-31T00:00:00Z"

currency
string | null

ISO 4217 currency code for the deal value.

Example:

"USD"

sourcePartnerId
integer<int32> | null

ID of the partner that sourced this deal.

Example:

7

status
enum<string>
Available options:
Unknown,
Pending,
Accepted,
Refused,
Expired
ownerUserId
integer<int32> | null

ID of the internal user to set as deal owner.

Example:

3

assignToPartnerOwner
boolean

When true, automatically assigns the deal owner from the source partner's owner.

Example:

true

Response

Deal created

id
integer<int32>
contactId
integer<int32>
sourcePartnerId
integer<int32> | null
stage
string | null
creationDate
string<date-time>
totalAmount
number<double> | null
properties
object | null
sourceLeadId
integer<int32> | null
status
enum<string>
Available options:
Unknown,
Pending,
Accepted,
Refused,
Expired
partners
object[] | null
contractStartDate
string<date-time> | null
contractEndDate
string<date-time> | null
ownerUserId
integer<int32> | null
owner
object
closeDate
string<date-time> | null
customerId
integer<int32> | null
currency
string | null