Create a deal

post https://{youraccountname}.api-us1.com/api/3/deals

Create a new deal

To create a deal, following permissions are required.

Deal permission: the user should have a permission to manage deals.
Pipeline-specific permission: the user should have a permission to manage the pipeline a new deal belongs to.

By default, primary contact and deal stage are also returned in the response.

{
  "deal": {
    "contact": "51",
    "account": "45",
    "description": "This deal is an important deal",
    "currency": "usd",
    "group": "1",
    "owner": "1",
    "percent": null,
    "stage": "1",
    "status": 0,
    "title": "AC Deal",
    "value": 45600,
    "fields": [
      {
        "customFieldId": 1,
        "fieldValue": "First field value"
      },
      {
        "customFieldId": 2,
        "fieldValue": "2008-01-20"
      },
      {
        "customFieldId": 3,
        "fieldValue": 5500,
        "fieldCurrency": "EUR"
      }
    ]
  }
}

Responses

Language

Credentials

Header

URL


xxxxxxxxxx
11
1
curl --request POST \
2
     --url https://youraccountname.api-us1.com/api/3/deals \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json' \
5
     --data '
6
{
7
  "deal": {
8
    "status": 0
9
  }
10
}
11
'

Choose an example:

application/json

201201

400400