Skip to main content
POST
/
v1
/
client
고객 생성
curl --request POST \
  --url https://openapi.pluuug.com/v1/client \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "status": {
    "id": 123
  },
  "companyName": "<string>",
  "inCharge": "<string>",
  "position": "<string>",
  "contact": "<string>",
  "email": "[email protected]",
  "content": "<string>",
  "businessRegistrationNumber": "<string>",
  "ceoName": "<string>",
  "companyAddress": "<string>",
  "companyDetailAddress": "<string>",
  "businessType": "<string>",
  "businessClass": "<string>",
  "branchNumber": "<string>",
  "fieldSet": [
    {
      "field": {
        "id": 123
      },
      "value": "<string>"
    }
  ],
  "taxInvoiceEmail": "<string>"
}
'
{
  "id": 123,
  "status": {
    "id": 123,
    "title": "<string>"
  },
  "companyName": "<string>",
  "inCharge": "<string>",
  "position": "<string>",
  "contact": "<string>",
  "email": "[email protected]",
  "created": "2023-11-07T05:31:56Z"
}

​
커스텀 필드

  • 플러그 Openapi는 고객의 커스텀 필드 값 수정을 지원합니다.
  • 커스텀 필드 자체의 수정은 비즈니스 설정 - 필드 설정 탭에서 수정하실 수 있습니다.
  • 수정 API의 field_set 필드를 활용하여 각 커스텀 필드의 값을 수정하실 수 있습니다.
  • 커스텀 필드는 총 8가지의 타입을 지원합니다.
  • 데이터 입력 예
데이터 타입입력 예시
텍스트 (String)
{
    “field”: {
         “id”: 1
    },
    “value”: “text”
}
숫자 (Number)
  • 소수점 입력 가능
{
    “field”: {
         “id”: 2
    },
    “value”: 12345
}
멤버 (Member)
  • 해당 필드의 ‘member_set’에서 id 선택
{
    “field”: {
         “id”: 3
    },
    “value”: [
        {
            “id”: 1
        },
        {
            “id”: 2
        }
    ]
}
날짜 (Date)
{
    “field”: {
         “id”: 4
    },
    “value”: “2025-03-01”
}
시간 (Time)
{
    “field”: {
         “id”: 5
    },
    “value”: “10:00:00”
}
토글 (Boolean)
{
    “field”: {
         “id”: 6
    },
    “value”: true
}
단수선택 리스트 (Single List)
  • 해당 필드의 ‘option_set’에서 id 선택
{
    “field”: {
         “id”: 7
    },
    “value”: {
        “id”: “FEWKSLVE2”
    }
}
복수선택 리스트 (Multi List)
  • 해당 필드의 ‘option_set’에서 id 선택
{
    “field”: {
         “id”: 8
    },
    “value”: [
        {
            “id”: “EFI4VLB2D”
        },
        {
            “id”: “BORE32VKE”
        }
    ]
}

Authorizations

​
X-API-Key
string
header
required

Body

​
status
object
required

고객 상태

​
companyName
string
required

회사명

Required string length: 1 - 128
​
inCharge
string | null
required

담당자

Required string length: 1 - 64
​
position
string | null
required

직책

Required string length: 1 - 64
​
contact
string | null
required

연락처

Required string length: 1 - 128
​
email
string<email> | null
required

이메일

Required string length: 1 - 128
​
content
string | null
required

메모

Minimum string length: 1
​
businessRegistrationNumber
string | null
required

사업자 등록번호

Required string length: 1 - 16
​
ceoName
string | null
required

대표자

Required string length: 1 - 128
​
companyAddress
string | null
required

소재지

Required string length: 1 - 256
​
companyDetailAddress
string | null
required

소재지 상세

Required string length: 1 - 256
​
businessType
string | null
required

업태

Required string length: 1 - 128
​
businessClass
string | null
required

종목

Required string length: 1 - 128
​
branchNumber
string | null
required

종사업장 번호

Required string length: 1 - 4
​
fieldSet
object[] | null
required

커스텀 필드

​
taxInvoiceEmail
string | null

세금계산서 전용 이메일

Required string length: 1 - 128

Response

​
id
integer
required
​
status
object
required

고객 상태

​
companyName
string
required

회사명

Maximum string length: 128
​
inCharge
string | null
required

담당자

Maximum string length: 64
​
position
string | null
required

직책

Maximum string length: 64
​
contact
string | null
required

연락처

Maximum string length: 128
​
email
string<email> | null
required

이메일

Maximum string length: 128
​
created
string<date-time>
required

생성일시