Mailchimp API 캠페인

메일침프(Mailchimp) 캠페인 API는 Mailchimp 계정의 이메일 캠페인을 만들고, 조회하고, 발송하고, 관리하는 데 필요한 모든 기능을 제공해요. 캠페인이란 Mailchimp 리스트(수신자 목록)에 이메일을 보내는 방식으로, Campaigns API 호출만으로 계정의 캠페인 전체를 코드로 다룰 수 있어요. 캠페인 생성·설정 수정·삭제부터 즉시 발송이나 예약 발송, RSS 캠페인 일시정지/재개, 테스트 이메일 발송, 캠페인 복제·재발송, 콘텐츠 설정까지 한 번에 처리할 수 있답니다.

캠페인 상태 관리는 send(즉시 발송), schedule(예약 발송), cancel-send(발송 취소), pause/resume(RSS 캠페인 일시정지·재개) 같은 액션 엔드포인트로 이뤄져요. 예약 발송된 캠페인은 발송이 시작되기 전에만 unschedule로 취소할 수 있어요.

출처: 문서

본문

캠페인 생성·조회·관리

캠페인 API의 핵심 CRUD 엔드포인트예요. 캠페인을 새로 만들고, 정보를 조회하고, 설정을 부분 업데이트하고, 삭제할 수 있어요.

GET    /campaigns                                    # 계정의 모든 캠페인 조회
POST   /campaigns                                    # 새 캠페인 생성 (Add campaign)
GET    /campaigns/{campaign_id}                      # 특정 캠페인 정보 조회
PATCH  /campaigns/{campaign_id}                      # 특정 캠페인 설정 일부/전체 수정
DELETE /campaigns/{campaign_id}                      # 계정에서 캠페인 제거

GET /campaigns는 계정 안의 모든 캠페인을 가져와요.
POST /campaigns는 새 Mailchimp 캠페인을 만들고, PATCH /campaigns/{campaign_id}는 특정 캠페인의 설정 중 일부 또는 전체를 수정해요.
DELETE /campaigns/{campaign_id}는 캠페인을 계정에서 완전히 제거해요.

캠페인 액션 (발송·예약·관리)

발송과 예약, 그리고 발송 전후의 관리 동작을 담당하는 엔드포인트예요. 모든 액션은 캠페인 id 하위의 actions 경로로 호출해요.

POST /campaigns/{campaign_id}/actions/send          # 캠페인 발송 (RSS 캠페인은 예약대로, 나머지는 즉시)
POST /campaigns/{campaign_id}/actions/schedule      # 캠페인 예약 발송
POST /campaigns/{campaign_id}/actions/unschedule    # 아직 발송 시작 전인 예약 캠페인 예약 취소
POST /campaigns/{campaign_id}/actions/cancel-send   # 발송 후 수신자 모두 받기 전에 취소 (Mailchimp Pro)
POST /campaigns/{campaign_id}/actions/pause         # RSS 캠페인 일시정지
POST /campaigns/{campaign_id}/actions/resume        # RSS 캠페인 재개
POST /campaigns/{campaign_id}/actions/replicate     # 저장(save) 또는 발송(send) 상태의 캠페인 복제
POST /campaigns/{campaign_id}/actions/test          # 테스트 이메일 발송
POST /campaigns/{campaign_id}/actions/create-resend # 특정 세그먼트 대상 재발송

send는 RSS 캠페인이면 설정된 일정에 따라, 나머지 캠페인은 즉시 발송돼요.
schedule은 발송 시각을 정해 예약해요. 다만 발송 시각을 테스트하는 멀티베리엇(Multivariate) 캠페인이나 RSS 캠페인은 schedule 대신 send 액션을 사용해야 해요.
cancel-send는 정규(Regular) 또는 일반 텍스트(Plain-Text) 캠페인을 발송 후, 모든 수신자가 받기 전에 취소하는 기능이며 Mailchimp Pro에서 제공돼요.
create-resend는 캠페인을 복제해 '열지 않은 구독자', '발송 이후 새 가입자' 같은 흔한 세그먼트에 재발송하는 단축 기능이에요.

캠페인 콘텐츠

HTML, 일반 텍스트, 템플릿 형태의 캠페인 본문 콘텐츠를 관리해요.

GET /campaigns/{campaign_id}/content   # 캠페인의 HTML·일반 텍스트 콘텐츠 조회
PUT /campaigns/{campaign_id}/content   # 캠페인 콘텐츠 설정

캠페인 피드백

팀원들이 캠페인을 함께 작업하는 동안 댓글을 달고, 답하고, 테스트 이메일을 보낼 수 있는 기능이에요.

GET    /campaigns/{campaign_id}/feedback                        # 팀 피드백 목록 조회
POST   /campaigns/{campaign_id}/feedback                        # 특정 캠페인에 피드백 추가
GET    /campaigns/{campaign_id}/feedback/{feedback_id}          # 특정 피드백 메시지 조회
PATCH  /campaigns/{campaign_id}/feedback/{feedback_id}          # 특정 피드백 메시지 수정
DELETE /campaigns/{campaign_id}/feedback/{feedback_id}          # 특정 피드백 메시지 삭제

발송 전 체크리스트

발송 전에 캠페인의 발송 체크리스트를 검토하고 문제를 해결할 수 있어요.

GET /campaigns/{campaign_id}/send-checklist   # 발송 체크리스트 검토

더 알아보기 (Learn more)

공식 문서