리드 생성

POST /v2/lead

리드를 생성합니다.

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 중 하나 이상은 필수)
memo	string	리드 생성 시 작성할 메모
pipelineId	string	리드가 소속 될 pipeline의 Id
pipelineStageId	string	리드가 소속 된 pipeline의 StageId (pipelineId의 파이프라인에 소속된 stage만 지정가능)
fieldList	array	생성할 리드의 데이터필드

Request

Example

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

Response

201

{
    "success": true,
    "data": {
        "lead":
            {
                "id": "<leadId>",
                "name": "생성한 리드의 이름",
                "createdAt": "2024-04-08T05:25:26.020Z"
            }
}

40x