SDKAPI
시작하기
Menu Close
API

권한 가이드

작성일 2026.11.13 | 수정일 2026.11.13

기본 규칙

  • 각 API 를 부르려면 그 API 에 맞는 권한이 키에 있어야 합니다. 권한이 없으면 403 으로 거절합니다.

  • 이 문서에 없는 조회(GET) API 는 그 기능의 조회 권한으로 판정됩니다.

  • 문서에 없는 등록 · 수정 · 삭제 API 는 부를 수 없습니다.

  • 권한은 키를 만드는 회원이 그 기능의 권한을 가지고 있을 때만 고를 수 있습니다.

  • 권한을 골라 만든 API Key 는 레거시 API 에 쓸 수 없습니다.

발송 권한과 허용 IP

발송 권한이 있는 API Key는 허용 IP 를 1개 이상 직접 지정해야 합니다. 발송 API 는 직접 지정한 IP 에서 부를 때만 성공합니다. 모든 IP 허용(0.0.0.0/0)과 클라우드 공급사 대역은 발송 허용 IP 로 쓸 수 없습니다.

Oauth2 는 발송 권한에 허용 IP 제한을 받지 않습니다.

권한 목록

기능

조회 권한

변경 권한

발송 권한

메시지

message:read

message:write

message:send

카카오

kakao:read

kakao:write

RCS

rbc:read

rbc:write

발신번호

senderid:read

senderid:write

주소록

contacts:read

contacts:write

수신거부 · 차단

block:read

block:write

파일

storage:read

storage:write

CRM

crm:read

crm:write

앱스토어

appstore:read

appstore:write

잔액 · 충전 내역

cash:read

단가

pricing:read

발송 한도

quota:read

더 많은 기능을 API Key 권한으로 쓸 수 있도록 준비하고 있습니다. 필요한 권한이 목록에 없거나 궁금한 점이 있으면 고객센터로 문의해 주세요.

메시지

권한

작업

메서드

경로

message:send

발송

POST

/messages/v4/send

POST

/messages/v4/send-many

POST

/messages/v4/send-many/detail

POST

/messages/v4/send-many/detail/v2

POST

/messages/v4/send-many/fast

POST

/messages/v5/send

그룹 발송

POST

/messages/v4/groups/:groupId/send

POST

/messages/v4/groups/fast/:groupId/send

예약 등록

POST

/messages/v4/groups/:groupId/schedule

POST

/messages/v4/groups/fast/:groupId/schedule

예약 시각 변경

PUT

/messages/v4/groups/:groupId/schedule

그룹 재발송

POST

/messages/v4/groups/:groupId/resend

실패 메시지 재발송

POST

/messages/v4/groups/resend-failed

메시지 재발송

POST

/messages/v4/messages/:messageId/resend

주소록 그룹 예약 발송

POST

/contacts/v1/schedules/groups/:groupId

message:write

그룹 생성

POST

/messages/v4/groups

POST

/messages/v4/groups/fast

그룹 삭제

DELETE

/messages/v4/groups/:groupId

DELETE

/messages/v4/groups/fast/:groupId

그룹에 메시지 추가 · 삭제

PUT, DELETE

/messages/v4/groups/:groupId/messages

PUT, DELETE

/messages/v4/groups/fast/:groupId/messages

예약 취소

DELETE

/messages/v4/groups/:groupId/schedule

주소록 예약 취소

DELETE

/contacts/v1/schedules/groups/:groupId

주소록 예약 메시지 취소

DELETE

/contacts/v1/schedules/messages/:messageId

message:read

메시지 목록

GET

/messages/v4/list, /messages/v5/list

message:read

그룹 목록

GET

/messages/v4/groups, /messages/v5/groups

message:read

그룹 상세

GET

/messages/v4/groups/:groupId, /messages/v4/groups/fast/:groupId

message:read

그룹의 메시지

GET

/messages/v4/groups/:groupId/messages, /messages/v4/groups/fast/:groupId/messages, /messages/v5/groups/:groupId/messages

message:read

그룹 미리보기

GET

/messages/v4/groups/:groupId/preview-messages

message:read

발신번호별 메시지

GET

/messages/v4/messages/sender-numbers/:from

message:read

통계

GET

/messages/v4/statistics, /messages/v5/statistics

message:read

일별 통계

GET

/messages/v4/statistics/daily, /messages/v5/statistics/daily

message:read

팩스 수신번호

GET

/fax/v1/fax-receive-numbers, /fax/v1/fax-receive-numbers/:faxReceiveNumberId

message:read

받은 팩스

GET

/fax/v1/received-faxes, /fax/v1/received-faxs/:receivedFaxId

카카오

권한

작업

메서드

경로

kakao:write

채널 연동 인증 토큰 요청

POST

/kakao/v2/channels/token, /kakao/v2/channels/token/:channelId

채널 연동

POST

/kakao/v2/channels, /kakao/v2/channels/:channelId/service

채널 연동 해제

DELETE

/kakao/v2/channels/:channelId

채널 공유

POST

/kakao/v2/channels/share/:channelId

채널 공유 해제

DELETE

/kakao/v2/channels/share/:channelId/:accountId

채널 그룹 초대

POST

/kakao/v2/channel-groups/invitations/:channelGroupId

채널 그룹 초대 취소

DELETE

/kakao/v2/channel-groups/invitations/:invitationId

채널 그룹 초대 수락

POST

/kakao/v2/channel-groups/invitations/:invitationId/accept

채널 그룹 초대 거절

POST

/kakao/v2/channel-groups/invitations/:invitationId/refuse

채널 그룹에서 내보내기

DELETE

/kakao/v2/channel-groups/:channelGroupId/channels/:channelId/kick

채널 그룹에서 나가기

DELETE

/kakao/v2/channel-groups/:channelGroupId/channels/:channelId/exit

알림톡 템플릿 등록

POST

/kakao/v2/templates

알림톡 템플릿 엑셀로 등록

POST

/kakao/v2/templates/excel, /kakao/v2/excel/templates

알림톡 템플릿 수정

PUT

/kakao/v2/templates/:templateId

알림톡 템플릿 이름 변경

PUT

/kakao/v2/templates/:templateId/name

알림톡 템플릿 삭제

DELETE

/kakao/v2/templates/:templateId

알림톡 템플릿 검수 요청

PUT

/kakao/v2/templates/:templateId/inspection

알림톡 템플릿 검수 요청 취소

PUT

/kakao/v2/templates/:templateId/inspection/cancel

알림톡 템플릿 휴면 해제

POST

/kakao/v2/templates/:templateId/relese-dormant

브랜드 메시지 템플릿 등록

POST

/kakao/v2/brand-templates

브랜드 메시지 템플릿 수정

PUT

/kakao/v2/brand-templates/:brandTemplateId

브랜드 메시지 템플릿 삭제

DELETE

/kakao/v2/brand-templates/:brandTemplateId

브랜드 메시지 템플릿 복사

POST

/kakao/v2/brand-templates/:brandTemplateId/copy

kakao:read

채널 목록 · 상세

GET

/kakao/v2/channels, /kakao/v2/channels/:channelId

채널 카테고리

GET

/kakao/v2/channels/categories

검색용 아이디 확인

GET

/kakao/v2/searchid

채널 그룹 목록 · 상세

GET

/kakao/v2/channel-groups, /kakao/v2/channel-groups/:channelGroupId

채널 그룹 초대 목록 · 상세

GET

/kakao/v2/channel-groups/invitations, /kakao/v2/channel-groups/invitations/:invitationId

템플릿 목록 · 상세

GET

/kakao/v2/templates, /kakao/v2/templates/:templateId

발송 가능한 템플릿

GET

/kakao/v2/templates/sendable

RCS

권한

작업

메서드

경로

rbc:write

브랜드 연동

POST

/rbc/v1/brands

브랜드 연동 해제

DELETE

/rbc/v1/brands/:brandId

템플릿 등록

POST

/rbc/v1/templates

템플릿 수정

PUT

/rbc/v1/templates/:templateId

템플릿 삭제

DELETE

/rbc/v1/templates/:templateId

템플릿 검수 취소

PUT

/rbc/v1/templates/:templateId/cancel

템플릿 동기화

PUT

/rbc/v1/templates/sync

rbc:read

브랜드 목록 · 상세

GET

/rbc/v1/brands, /rbc/v1/brands/:brandId

템플릿 목록 · 상세

GET

/rbc/v1/templates, /rbc/v1/templates/:templateId

공통 템플릿

GET

/rbc/v1/templates/commons, /rbc/v1/templates/commons/:templateId

서식

GET

/rbc/v1/templates/forms, /rbc/v1/templates/forms/:templateId

발신번호

권한

작업

메서드

경로

senderid:read

발신번호 목록

GET

/senderid/v1/numbers

활성 발신번호

GET

/senderid/v1/numbers/active

번호 정보

GET

/senderid/v1/check-numbers/:phoneNumber

별칭 조회

GET

/senderid/v1/extra-data/numbers

senderid:write

별칭 등록

POST

/senderid/v1/extra-data/numbers

별칭 삭제

DELETE

/senderid/v1/extra-data/numbers

주소록

권한

작업

메서드

경로

contacts:write

폴더 추가

POST

/contacts/v1/folders

폴더 수정

PUT

/contacts/v1/folders/:folderId

폴더 삭제

DELETE

/contacts/v1/folders, /contacts/v1/folders/:folderId

명단 추가

POST

/contacts/v1/folders/:folderId/people

명단 수정

PUT

/contacts/v1/folders/:folderId/people

명단 삭제

DELETE

/contacts/v1/folders/:folderId/people

명단을 다른 폴더로 복사

POST

/contacts/v1/folders/:folderId/people/copy

발송 준비

POST

/contacts/v1/prepare

발송 준비 취소

PUT

/contacts/v1/prepare/:groupId/stop

contacts:read

폴더 목록

GET

/contacts/v1/folders

폴더 명단

GET

/contacts/v1/folders/:folderId/people

명단 검색

GET

/contacts/v1/people

발송 준비 상태

GET

/contacts/v1/prepare/:groupId

수신거부 · 차단

권한

작업

메서드

경로

block:write

차단 그룹 추가 · 수정

POST

/iam/v1/block/groups

차단 그룹 삭제

DELETE

/iam/v1/block/groups/:blockGroupId

차단 번호 추가 · 수정

POST

/iam/v1/block/numbers

차단 번호 대량 추가

POST

/iam/v1/block/numbers/bulk

그룹에서 차단 번호 빼기

DELETE

/iam/v1/block/groups/:blockGroupId/numbers/:blockNumberId

block:read

080 수신거부 · KISA 차단 목록

GET

/iam/v1/black

차단 그룹 목록

GET

/iam/v1/block/groups

차단 번호 목록

GET

/iam/v1/block/numbers

파일

권한

작업

메서드

경로

storage:write

업로드

POST

/storage/v1/files

삭제

DELETE

/storage/v1/files/:fileId

storage:read

파일 목록

GET

/storage/v1/files

파일 상세

GET

/storage/v1/files/:fileId

CRM

권한

작업

메서드

경로

crm:read

엔티티 목록 · 상세

GET

/crm-core/v1/entities, /crm-core/v1/entities/:entityId

속성 목록 · 상세

GET

/crm-core/v1/properties, /crm-core/v1/properties/:propertyId

레코드 목록 · 상세

GET

/crm-core/v1/records, /crm-core/v1/records/:recordId

레코드 상세 검색

POST

/crm-core/v1/records/search/advanced

레코드 전문 검색

GET

/crm-core/v1/records/search/fulltext/:entityId

중복 레코드 찾기

POST

/crm-core/v1/records/duplicates

내보내기 상태

GET

/crm-core/v1/records/export/:jobId/status

관계 목록

GET

/crm-core/v1/relationships/list, /crm-core/v1/relationships/record/:recordId, /crm-core/v1/relationships/type/:relationshipTypeId

관계 유형 목록

GET

/crm-core/v1/relationships/types

활동 목록 · 상세

GET

/crm-core/v1/activities, /crm-core/v1/activities/:activityId, /crm-core/v1/activities/record/:recordId

세그먼트 목록 · 상세

GET

/crm-core/v1/segments, /crm-core/v1/segments/:segmentId

세그먼트 레코드

GET

/crm-core/v1/segments/:segmentId/records

세그먼트 평가

POST

/crm-core/v1/segments/:segmentId/evaluate

요금제

GET

/crm-core/v1/plans/definitions, /crm-core/v1/plans/me

청구 내역

GET

/crm-core/v1/plans/me/billing-logs, /crm-core/v1/plans/me/billing-logs/:logId, /crm-core/v1/plans/me/receipts/:logId

다음 결제 · 초과 사용

GET

/crm-core/v1/plans/me/next-billing, /crm-core/v1/plans/me/overage

crm:write

엔티티 추가

POST

/crm-core/v1/entities

엔티티 수정 · 삭제

PATCH, DELETE

/crm-core/v1/entities/:entityId

속성 추가

POST

/crm-core/v1/properties, /crm-core/v1/properties/bulk

속성 수정 · 삭제

PATCH, DELETE

/crm-core/v1/properties/:propertyId

crm:write + message:send

레코드 생성

POST

/crm-core/v1/records

레코드 수정

PATCH

/crm-core/v1/records/:recordId

레코드 대량 수정

POST

/crm-core/v1/records/bulk/update

레코드 복원

POST

/crm-core/v1/records/bulk/restore

CSV 가져오기

POST

/crm-core/v1/records/import/csv

crm:write

레코드 삭제

DELETE

/crm-core/v1/records/:recordId

레코드 대량 삭제

POST

/crm-core/v1/records/bulk/delete

내보내기 요청

POST

/crm-core/v1/records/export/request

관계 추가

POST

/crm-core/v1/relationships, /crm-core/v1/relationships/bulk, /crm-core/v1/relationships/bulk-match

관계 수정 · 삭제

PATCH, DELETE

/crm-core/v1/relationships/:relationshipId

관계 유형 추가

POST

/crm-core/v1/relationships/types

관계 유형 수정 · 삭제

PATCH, DELETE

/crm-core/v1/relationships/types/:relationshipTypeId

활동 추가

POST

/crm-core/v1/activities

활동 수정 · 삭제

PATCH, DELETE

/crm-core/v1/activities/:activityId

활동 완료 처리

POST

/crm-core/v1/activities/:activityId/complete

세그먼트 삭제

DELETE

/crm-core/v1/segments/:segmentId

초과 사용 설정

PUT

/crm-core/v1/plans/me/overage-settings

앱스토어

권한

작업

메서드

경로

appstore:write

앱 등록

POST

/appstore/v2/me/apps

앱 수정 · 삭제

PUT, DELETE

/appstore/v2/me/apps/:appId

앱 공개 단계 변경

PUT

/appstore/v2/me/apps/:appId/stage

앱 썸네일 올리기

POST

/appstore/v2/me/apps/:appId/images/thumbnail

앱 스크린샷 올리기

POST

/appstore/v2/me/apps/:appId/images/screenshots

앱홈 등록 · 수정

POST, PUT

/appstore/v2/me/apps/:appId/apphome

앱홈 수익금 설정

POST, PUT, DELETE

/appstore/v2/me/apps/:appId/apphome/profit

서브계정 추가 · 삭제

POST, DELETE

/appstore/v2/me/apps/:appId/subaccounts

서브계정 수정

PUT

/appstore/v2/me/apps/:appId/subaccounts/:accountId

서브계정 사용자 정의 필드 삭제

DELETE

/appstore/v2/me/apps/:appId/subaccounts/customfields

appstore:read

앱 목록

GET

/appstore/v2/me/apps

앱홈 수익금 설정

GET

/appstore/v2/me/apps/:appId/apphome/profit

서브계정 목록

GET

/appstore/v2/me/apps/:appId/subaccounts

수익금

GET

/appstore/v2/profits, /appstore/v2/profits/daily/detail

잔액 · 단가 · 발송 한도

권한

작업

메서드

경로

cash:read

잔액

GET

/cash/v1/balance

잔액 변동 내역

GET

/cash/v1/balance/history

충전 내역

GET

/cash/v1/recharge/history

무료 제공량

GET

/cash/v1/freetier

잔액 부족 알림 설정

GET

/cash/v1/balance/alert

견적서

GET

/cash/v1/estimate

거래명세서

GET

/cash/v1/receipt

세금계산서 목록

GET

/cash/v1/taxinvoice

출금 내역

GET

/cash/v1/withdraw

전용 입금 계좌

GET

/exclusive-account/v1/accounts

선불 결제 내역

GET

/prepayment/v1/payments, /prepayment/v1/payments/:historyId

pricing:read

메시지 단가

GET

/pricing/v1/messaging

국가별 단가

GET

/pricing/v1/messaging/countries

quota:read

발송 한도

GET

/quota/v1/me

한도 변경 추정

GET

/quota/v1/estimate

시스템 한도 증가 요청 목록

GET

/quota/v1/me/system

거절 메시지

메시지

뜻

이 API Key 에는 <권한> 권한이 없습니다.

키에 그 권한을 더해 다시 만들어야 합니다.

발송은 API Key 에 직접 지정한 IP 에서만 할 수 있습니다.

요청한 IP 가 키의 허용 IP 에 없습니다.

CRM 레코드 변경은 자동화로 메시지가 나갈 수 있어 message:send 권한도 필요합니다.

CRM 레코드 변경에 발송 권한이 빠졌습니다.

API Key 로는 계정 · 자격증명 · 결제 설정 API 를 부를 수 없습니다.

권한과 상관없이 막힌 API 입니다.

이 작업은 API Key 로 할 수 없습니다. 콘솔에서 진행해 주세요.

콘솔에서만 하는 작업입니다.

아직 API Key 권한을 준비 중인 기능이라 부를 수 없습니다.

권한을 준비하고 있는 기능입니다.

이 API Key 로 부를 수 없는 API 입니다.

권한 목록에 없는 API 입니다.