세일즈맵 가이드북
도입문의블로그가이드 영상
세일즈맵 개발자 센터
세일즈맵 개발자 센터
  • 👋 세일즈맵 개발자 센터입니다
  • API Reference
    • Authentication
    • API Endpoints
    • Rate limiting
    • fieldList
    • 딜
      • 딜 목록 조회
      • 딜 단일 조회
      • 딜 생성
      • 딜 수정
      • 딜 삭제
      • 딜 견적서 조회
      • 딜 히스토리 목록 조회
      • 딜 액티비티 목록 조회
    • 리드
      • 리드 목록 조회
      • 리드 단일 조회
      • 리드 생성
      • 리드 수정
      • 리드 견적서 조회
      • 리드 히스토리 목록 조회
      • 리드 액티비티 목록 조회
    • 고객
      • 고객 목록 조회
      • 고객 단일 조회
      • 고객 생성
      • 고객 수정
      • 고객 히스토리 목록 조회
      • 고객 액티비티 목록 조회
    • 회사
      • 회사 목록 조회
      • 회사 단일 조회
      • 회사 생성
      • 회사 수정
      • 회사 히스토리 목록 조회
      • 회사 액티비티 목록 조회
    • 상품 & 견적서
      • 상품 목록 조회
      • 견적서 생성
    • 웹폼
      • 웹폼 목록 조회
      • 웹폼 제출 내역조회
    • TODO 목록 조회
    • 노트 목록 조회
    • 파이프라인 목록 조회
    • 유저 목록 조회
    • 팀 목록 조회
  • 웹훅(Webhook)
    • 웹훅 이벤트
    • 웹훅 등록
    • 웹훅 형태
    • 재전송 정책
Powered by GitBook
On this page

Was this helpful?

  1. API Reference
  2. 리드

리드 생성

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 중 하나 이상은 필수)

status

string

리드와 연결된 고객의 Id

("New", "Nurturing", "MQL", "Working", "Archive" 중 하나만 가능) Required

price

number

리드의 금액

memo

string

리드 생성 시 작성할 메모

fieldList

array

생성할 리드의 데이터필드

Response

{
    "success": true,
    "data": {
        "lead":
            {
                "id": "<leadId>",
                "name": "생성한 리드의 이름",
                "createdAt": "2024-04-08T05:25:26.020Z"
            }
}
{
    "success": false,
    "message": "에러 메세지"
}
Previous리드 단일 조회Next리드 수정

Last updated 4 months ago

Was this helpful?