POST/contact-tags

회사 연락처 태그를 생성한다.

도메인 옵션에 따라 권한이 있는 경우에만 가능하다.

Authorization

oauth2

OAuth 2.0 인증.
자세한 인증 방식은 인가·인증을 참고한다.

Scope

contact

HTTP Request

POSThttps://www.worksapis.com/v1.0/contact-tags

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 
Content-Type string 

application/json


required
example : application/json 

Request Body

PropertyTypeDescription
contactTagName string 

태그 이름


required
maxLength : 30 

Request Example

example

1{2  "contactTagName": "company tag"3}

Response

HTTP 201

OK

PropertyTypeDescription
contactTagId string 

연락처 태그 ID


readOnly : true 
contactTagName string 

태그 이름


required
maxLength : 30 
type string 

태그 타입

  • COMPANY: 회사 태그
  • USER: 사용자 태그

Allowed values : COMPANY, USER
readOnly : true 
userId string 

사용자 태그 생성자

  • 사용자 태그인 경우에만 표시됨

readOnly : true 

Response Example

example

1{2  "contactTagId": "ctag2a81-94b6-4642-6903-03aa7977da91",3  "contactTagName": "company tag",4  "type": "COMPANY"5}

HTTP 400

Bad Request

HTTP 403

Forbidden