딜 생성
딜을 생성합니다
POST
Example Request
Example Response
Header
Authorization
required string
Bearer 토큰을 포함한 인증 헤더입니다.
Body
name
required string
딜의 이름을 설정합니다.
price
string
딜의 금액을 설정합니다.
pipelineName
required string
딜이 포함될 파이프라인을 설정합니다.
pipelineStageName
string
딜이 포함될 파이프라인 단계를 설정합니다.
빈 값으로 설정한 경우, 파이프라인 첫번째 단계로 설정됩니다.
source
string
딜의 소스를 설정합니다.
딜/리드 데이터필드에서 소스의 선택리스트를 확인해주세요.
소스는 선택리스트 중 하나의 값으로만 설정 가능합니다. source 값을 전달하지 않는 경우 “직접 생성”으로 설정됩니다.
ownerName
string
딜의 담당자를 지정합니다.
같은 워크스페이스에 등록된 담당자의 이름을 지정해주세요.
해당필드 없이 post 요청을 하면, 해당 요청의 토큰에 해당하는 user가 담당자로 지정됩니다.
memo
string
딜의 생성과 동시에 해당 딜에 작성할 노트의 본문 내용입니다.
fieldList
json
딜의 이름, 금액, 소스를 제외한 필드값을 설정합니다.
세일즈맵 탭에서 [회사 설정] - [데이터 필드 관리]을 클릭하면 딜의 데이터 필드를 확인할 수 있습니다.
name 에는 field 의 이름을 입력합니다.
field 의 유형이 텍스트나 단일 선택인 경우에는 stringValue 에 값을 설정하고, field 의 유형이 숫자인 경우에는 numberValue 에 값을 설정하고, field 의 유형이 날짜인 경우에는 dateValue 에 값을 설정합니다. field 의 유형이 복수 선택인 경우에는 stringValueList에 string list 형태로 값을 설정합니다.
peopleName
string
딜과 연결된 고객의 이름을 설정합니다. peopleName과 peopleEmail을 입력하는 경우 두 값이 모두 필요합니다.
peopleEmail
string
딜과 연결된 고객의 이메일을 설정합니다.
같은 이메일의 고객이 존재하는 경우 기존의 고객과 연결하고, 같은 이메일의 고객이 존재하지 않는 경우 새로운 고객을 생성하고 딜과 연결합니다.
peopleFieldList
json
딜과 연결된 고객의 이름과 이메일을 제외한 필드값을 설정합니다.
세일즈맵 탭에서 [회사 설정] - [데이터 필드 관리]을 클릭하면 고객의 데이터 필드를 확인할 수 있습니다.
name 에는 field 의 이름을 입력합니다.
field 의 유형이 텍스트나 단일 선택인 경우에는 stringValue 에 값을 설정하고, field 의 유형이 숫자인 경우에는 numberValue 에 값을 설정하고, field 의 유형이 날짜인 경우에는 dateValue 에 값을 설정합니다. field 의 유형이 복수 선택인 경우에는 stringValueList에 string list 형태로 값을 설정합니다.
organizationName
string
딜과 연결된 회사의 이름을 설정합니다.
같은 이름의 회사가 존재하는 경우 기존의 회사와 연결하고, 같은 이름의 회사가 존재하지 않는 경우 새로운 회사를 생성하고 딜과 연결합니다.
organizationFieldList
json
딜과 연결된 회사의 이름을 제외한 필드값을 설정합니다.
세일즈맵 탭에서 [회사 설정] - [데이터 필드 관리]을 클릭하면 회사의 데이터 필드를 확인할 수 있습니다.
name 에는 field 의 이름을 입력합니다.
field 의 유형이 텍스트나 단일 선택인 경우에는 stringValue 에 값을 설정하고, field 의 유형이 숫자인 경우에는 numberValue 에 값을 설정하고, field 의 유형이 날짜인 경우에는 dateValue 에 값을 설정합니다. field 의 유형이 복수 선택인 경우에는 stringValueList에 string list 형태로 값을 설정합니다.
Response
success
boolean
요청을 성공적으로 완료한 경우 true, 실패한 경우 false 입니다.
data
object
생성한 딜 정보입니다.
딜 정보 데이터
id
string
딜의 고유 id 입니다. 딜을 생성할 때 사용합니다.
name
string
생성한 딜의 이름입니다.
price
string
생성한 딜의 금액입니다.
source
string
생성한 딜의 소스입니다.
people
string
생성한 딜의 고객 정보입니다.
organization
string
생성한 딜의 회사 정보입니다.
createdAt
string
딜이 생성된 날짜입니다.