딜 생성

POST /v2/deal

딜을 생성합니다.

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Body parameters

Name	Type	Description
name	string	생성하려는 딜의 이름 Required
peopleId	string	딜과 연결된 고객의 Id Required (peopleId 혹은 organizationId 중 하나 이상은 필수)
organizationId	string	딜과 연결된 회사의 Id Required (peopleId 혹은 organizationId 중 하나 이상은 필수)
status	string	딜의 상태 ("Won", "Lost", "In progress" 중 하나만 가능) Required
price	number	딜의 금액
memo	string	딜 생성 시 작성할 메모
pipelineId	string	딜이 소속 될 pipeline의 Id Required
pipelineStageId	string	딜이 소속 된 pipeline의 StageId (pipelineId의 파이프라인에 소속된 stage만 지정가능) Required
fieldList	array	생성할 딜의 데이터필드

Request

Example

{
  "name": "딜 명",
  "organizationId": "<회사 ID>",
  "peopleId": "<고객 ID>",
  "pipelineId": "<파이프라인 ID>",
  "pipelineStageId": "<파이프라인 단계 ID>",
  "fieldList": [
    {
      "name" : "<필드 이름>",
      "stringValue": "<텍스트 입력>"
  }
  ]
}

Response

201

{
    "success": true,
    "data": {
        "deal":
            {
                "id": "<dealId>",
                "name": "생성한 딜의 이름",
                "createdAt": "2024-04-08T05:25:26.020Z"
            }
}

40x