개인 API 키로 Zapier 연결하기
Zapier용 Marcomm AI 앱으로 보도자료, 블로그 글, 프레스 이벤트에서 Zap을 시작하고, 이것들을 만들고 공개하고 송출합니다. 앱은 초대로만 쓸 수 있습니다.
- 1Marcomm에서 설정 → 연동 → Zapier로 가서 지금 상태와 필요한 값을 확인합니다.

Zapier 화면에는 지금 상태, 연결 단계, 복사할 값, 이 워크스페이스의 API 사용 승인 여부가 나옵니다. - 2설정 → API를 엽니다. 워크스페이스에 아직 API 사용 승인이 없으면 소유자나 관리자가 API 사용 신청을 채우고 신청하기를 누릅니다.
- 3승인되면 키 만들기를 열고 개인 키를 고른 뒤 필요한 범위를 체크하고 키 만들기를 누릅니다. 키는 한 번만 보이니 바로 복사합니다.
- 4Marcomm AI에서 받은 초대 링크를 열고 Zapier 계정에 Marcomm AI 앱을 추가합니다.
- 5Zap을 만들고 트리거나 액션으로 Marcomm AI를 고른 뒤, Zapier가 연결을 요청하면 API Key(API 키)에 키를 붙여 넣습니다.
공개와 송출 단계는 되돌릴 수 없으니 먼저 초안으로 시험하세요.
앱은 아직 Zapier 공개 디렉터리에 없어 Marcomm AI의 초대 링크가 필요합니다. 트리거는 New Press Release, Press Release Approval Requested, Press Release Published, New Blog Post, Blog Post Published, New Press Event, RSVP Invite Updated 일곱 가지입니다. 액션은 보도자료를 만들고 고치고 승인을 요청하고 공개하고 송출하며, 블로그 글을 만들고 공개하고, 프레스 이벤트를 만들고, RSVP 초대장을 만들고 받는 사람을 더하고 보냅니다. 검색 두 가지로 보도자료나 블로그 글을 찾습니다.
범위는 키가 할 수 있는 일을 정합니다. 콘텐츠(content)는 보도자료, 블로그 글, 프레스 이벤트를 읽고, 콘텐츠 작성(content:write)은 초안을 만들고 고치며, 공개와 송출(distribution)은 공개하고 이메일로 보내고, 승인(approvals)은 승인 단계를 다룹니다. 뒤의 세 범위는 개인 키로만 쓸 수 있습니다. 한 일이 키를 만든 사람의 이름으로 기록되기 때문입니다. 워크스페이스 키는 읽기만 할 수 있고, 모든 키는 만든 사람의 역할과 권한으로 동작합니다.
공개와 송출은 되돌릴 수 없습니다. API는 요청에 confirm: true나 Idempotency-Key 헤더가 있을 때만 실행하고, 아직 승인이 필요하거나 예약 공개 또는 엠바고가 걸린 글이면 공개하지 않고 409로 답합니다. 같은 Idempotency-Key로 같은 요청을 다시 보내면 24시간 동안 다시 실행하지 않고 처음 결과를 돌려줍니다. 쓰기 단계마다 Zap과 입력값으로 만든 멱등 키를 보냅니다. 24시간 안에 완전히 같은 단계를 일부러 다시 실행해야 하면 Repeat Key에 실행마다 달라지는 값을 넣으세요.
API는 Team 요금제 이상에서 쓸 수 있습니다. Marcomm AI 팀이 신청을 하나씩 심사하며, 키는 승인된 뒤에만 동작합니다. 키에는 워크스페이스에 승인된 범위만 넣을 수 있고, 한 사람당 키를 10개까지 만들 수 있습니다. 기본 한도는 워크스페이스당 분당 60회, 하루 10,000회이며, 넘으면 API가 Retry-After 헤더와 함께 429로 답합니다. 한도를 올리려면 설정 → API의 한도를 더 올려야 하나요?를 쓰세요. Zapier 연결을 끊으려면 키 옆의 끄기를 누릅니다. 그 키를 쓰던 시스템은 바로 접근을 잃습니다.
자주 묻는 질문
Authorization: Bearer뒤에 키를 붙인 헤더로GET https://marcomm.works/api/v1/me를 호출하세요. 범위와 상관없이 승인된 키면 동작하고, 워크스페이스와 키 이름, 키의 범위를 돌려줍니다.키에는 어떤 서비스가 쓰는지 기록되지 않아 Marcomm이 Zapier 카드를 연결됨으로 표시하지 않습니다. 각 키를 마지막으로 쓴 시각은 설정 → API에서 확인합니다.
할 수 없습니다. Zapier 앱은 승인을 요청할 수 있고, 결정은 승인자가 Marcomm에서 합니다. API로는 승인 범위가 있는 개인 키로 승인하거나 반려할 수 있습니다.