Create a deal

curl --request POST \
  --url https://api.hubapi.com/deals/v1/deal/ \
  --header 'Content-Type: application/json' \
  --data '{
  "properties": [
    {
      "name": "<string>",
      "value": "<string>"
    }
  ],
  "associations": {
    "associatedCompanyIds": [
      123
    ],
    "associatedVids": [
      123
    ]
  }
}'

{
  "portalId": 123,
  "dealId": 123,
  "isDeleted": true,
  "associations": {},
  "properties": {}
}

Deals

Create a deal

The create a deal endpoint is used to create and track deals in HubSpot. It also allows you to connect HubSpot with an external CRM or other sales management software. What’s a use case for this endpoint? Your company uses HubSpot along with an external CRM and website hosting platform. Your sales team uses the create a deal endpoint to make sure that certain sales activity in the CRM will automatically create a deal in HubSpot. Additionally, when a contact submits a sales qualification form on your website, this endpoint creates a deal in HubSpot.

Associations

You can (but are not required to) create associations between deals and other CRM objects the same way you would create an association between companies and contacts.

Properties

You can pass any custom property value to the Deals API as long as you create the property first. While the dealstage property and pipeline property are not required, it is recommended to specify both, especially on accounts with multiple pipelines. If left unspecified, the default pipeline is assumed. You can manage pipelines and dealstages through the CRM Pipelines API.

POST

deals

deal

Create a deal

curl --request POST \
  --url https://api.hubapi.com/deals/v1/deal/ \
  --header 'Content-Type: application/json' \
  --data '{
  "properties": [
    {
      "name": "<string>",
      "value": "<string>"
    }
  ],
  "associations": {
    "associatedCompanyIds": [
      123
    ],
    "associatedVids": [
      123
    ]
  }
}'

{
  "portalId": 123,
  "dealId": 123,
  "isDeleted": true,
  "associations": {},
  "properties": {}
}

Body

application/json

Response

200 - application/json

Successful response - Deal created successfully

The response is of type object.

Get recently created deals

Update a deal

Analytics and Events

Automation

CMS

CRM

Settings

OAuth

Marketing

Create a deal

Associations

Properties

Body

Response