Skip to main content
POST
/
deals
/
Create a deal
curl --request POST \
  --url https://api.journeybee.io/v1/deals/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "lead_uuid": "<string>",
  "label": "<string>",
  "deal_value": 0,
  "stage_uuid": "<string>",
  "currency_uuid": "<string>",
  "expiration_date": "<string>",
  "tag_uuids": [
    "<string>"
  ],
  "custom_fields": [
    {
      "custom_field_uuid": "<string>",
      "value": {
        "text": "<string>",
        "number": 123,
        "date": "<string>",
        "boolean": true,
        "select": 123,
        "multi_select": [
          123
        ]
      }
    }
  ]
}
'
{
  "uuid": "<string>",
  "label": "<string>",
  "deal_value": 123,
  "total_commission_value": 123,
  "expiration_date": "<string>",
  "stage": {
    "uuid": "<string>",
    "label": "<string>"
  },
  "lead": {
    "uuid": "<string>",
    "first_name": "<string>",
    "last_name": "<string>",
    "email": "<string>",
    "company_name": "<string>"
  },
  "partner": {
    "uuid": "<string>",
    "name": "<string>"
  },
  "currency": {
    "uuid": "<string>",
    "code": "<string>",
    "label": "<string>"
  },
  "tags": [
    {
      "uuid": "<string>",
      "label": "<string>"
    }
  ],
  "assigned_users": [
    {
      "uuid": "<string>",
      "email": "<string>",
      "first_name": "<string>",
      "last_name": "<string>"
    }
  ],
  "custom_fields": [
    {
      "uuid": "<string>",
      "label": "<string>",
      "value": {
        "text": "<string>",
        "number": 123,
        "date": "<string>",
        "boolean": true,
        "select": 123,
        "multi_select": [
          123
        ]
      },
      "options": [
        {
          "id": 123,
          "label": "<string>"
        }
      ]
    }
  ],
  "created_at": "<string>",
  "updated_at": "<string>"
}

Authorizations

Authorization
string
header
required

API key authentication. Use "Bearer <api_key>" or "Api-Key <api_key>".

Body

application/json
lead_uuid
string
required
label
string
required
deal_value
number
default:0
required

Monetary amount in WHOLE currency units (the displayed amount, e.g. 1000.00 = one thousand) — NOT minor units/cents. Do NOT divide or multiply by 100; send and show the amount as-is.

stage_uuid
string
currency_uuid
string
expiration_date
string | null
tag_uuids
string[]
custom_fields
object[]

Response

201 - application/json

Default Response

uuid
string
required
label
string
required
deal_value
number
required

Monetary amount in WHOLE currency units (the displayed amount, e.g. 1000.00 = one thousand) — NOT minor units/cents. Do NOT divide or multiply by 100; send and show the amount as-is.

total_commission_value
number | null
required

Monetary amount in WHOLE currency units (the displayed amount, e.g. 1000.00 = one thousand) — NOT minor units/cents. Do NOT divide or multiply by 100; send and show the amount as-is.

expiration_date
string | null
required
stage
object
required
lead
object
required
partner
object
required
currency
object
required
tags
object[]
required
assigned_users
object[]
required
custom_fields
object[]
required
created_at
string
required
updated_at
string
required