발신
이메일 발송
트랜잭션 메시지, 일괄 발송, 답장, 첨부 파일, 호스팅 템플릿을 안전하게 발송합니다.
메시지 콘텐츠
검증된 워크스페이스 도메인의 from ID, 수신자 to 하나 이상, 그리고 HTML, 텍스트 또는 게시된 호스팅 템플릿 하나를 지정하세요. 원본 콘텐츠 발송에서는 subject를 생략할 수 있으며, 이 경우 제목이 비어 있게 됩니다. SendHQ는 필요할 때 HTML에서 일반 텍스트 대체본을 생성하지만, 직접 작성한 대체본이 더 안정적입니다.
수신자와 크레딧
메시지 하나에는 To, Cc, Bcc를 합쳐 최대 100개의 대상을 넣을 수 있습니다. 각 대상은 수신자 전송 크레딧을 1개씩 소모합니다. 정규화한 뒤 중복되는 수신자 주소는 발송 제외 여부를 한 번만 확인하지만, 모든 대상은 여전히 메시지 한도에 포함됩니다.
안전한 재시도
단건 및 일괄 발송에는 최대 200자의 고정된 Idempotency-Key를 보내세요. 동일한 JSON 페이로드로 키를 재사용하면 저장된 응답을 그대로 다시 반환하며 Idempotent-Replayed: true가 추가됩니다. 같은 키로 수신자, 콘텐츠, 헤더, 템플릿 데이터 중 무엇이라도 바꾸면 409가 반환됩니다. 첫 요청이 처리 중일 때 같은 키의 동시 요청도 409를 반환합니다.
일괄 발송
POST /emails/batch는 메시지 객체를 최대 100개까지 받으며 각 위치별로 결과를 반환합니다. 개인화된 템플릿 데이터는 하나의 개인화 템플릿을 여러 수신자에게 보내지 말고 메시지 객체를 따로 만들어 사용하세요.
답장과 스레드
답장할 때는 reply_to_email_id를 설정하세요. SendHQ가 Message-ID, In-Reply-To, References와 기존 스레드 ID를 자동으로 채웁니다. 전체 대화는 GET /threads/:id로 조회합니다.