문서로 건너뛰기
API

양식으로 가입하기

게시된 양식의 방문자가 전송하는 곳입니다. 자격 증명이 필요 없으므로 브라우저나 내 서버에서, 어떤 오리진에서든 호출할 수 있습니다.

POST/subscribe/{formId}

워크스페이스에 실제 호출을 실행합니다.

POST /subscribe/{formId}

게시된 양식의 방문자가 전송하는 곳입니다. 자격 증명이 필요 없으므로 브라우저나 내 서버에서, 어떤 오리진에서든 호출할 수 있습니다.

예시

답변은 필드 키를 키로 삼아 최상위나 values 아래에 넣어 보내세요. Accept: application/json을 보내거나 본문이 JSON이면 응답은 JSON입니다. 순수 HTML 양식은 대신 303으로 리디렉션됩니다.

curl
curl -X POST "$OE/subscribe/frm_3b9d2e7a1c4f80d56e2a9b14" -H 'content-type: application/json' -d '{  "email": "[email protected]",  "first_name": "Ann",  "consent": true}'
응답
{  "object": "form_subscription",  "formId": "frm_3b9d2e7a1c4f80d56e2a9b14",  "outcome": "pending",  "redirectUrl": null}

outcome은 그 사람이 이제 오디언스에 들어가 있으면 added, 더블 옵트인 양식이면 pending이며, 이때 그 사람은 이메일로 확인하면 오디언스에 들어갑니다. 그 이메일은 이 응답 뒤에 나가지만, 최근 10분 안에 이 양식이 그 주소로 메일을 보냈거나 그 주소가 오늘 이 워크스페이스에서 다섯 통을 받았다면 나가지 않습니다.

답변이 빠졌거나 잘못되면 422 invalid_form_submission입니다. 오류에는 fields가 담기는데, 이는 required, email, option 같은 이유가 담긴 { "key", "error" }의 목록입니다.

일시 중지된 양식은 409 form_closed, 알 수 없거나 게시되지 않은 양식은 404 form_not_found, 한 네트워크에서 가입이 너무 많으면 429 form_rate_limited로 응답합니다. 순수 HTML 양식은 대신 호스팅된 페이지로 가는 303을 받습니다.

양식에 없는 키의 답변은 무시되며, oe_로 시작하는 키는 절대 저장되지 않습니다. oe_source는 양식이 있던 페이지를 나타내며, 기본값은 Referer 헤더입니다.

받은편지함을,
내 방식대로.

기업, AI, 에이전트, 개인 메일을 위한 이메일 인프라. 규모와 프라이버시, 통제권을 위해 만들었습니다. 이메일이 처음부터 갖췄어야 할 모든 것.

© 2026 OpenEmail. 모든 권리 보유.