API
사람 추가와 내보내기
트리거와 상관없이 연락처를 게시 중인 자동화의 첫 단계에 넣거나, 끝나기 전에 사람을 내보냅니다.
POST/automations/{id}/enrollments
2개 호출을 워크스페이스에 실제로 실행합니다.
POST /automations/{id}/enrollments
트리거와 상관없이 연락처를 게시 중인 자동화의 첫 단계에 넣거나, 끝나기 전에 사람을 내보냅니다.
예시
automations:write가 필요합니다. 연락처는 email 또는 contactId 중 하나로만 지정하고, 둘을 함께 쓰지 않습니다.
curl -X POST "$OE/automations/aut_7c2e9a1f4b8d30c65e1a9f27/enrollments" -H "$AUTH" -H 'content-type: application/json' -d '{ "email": "[email protected]", "data": { "orderId": "A-1042" }}'curl -X POST "$OE/automations/aut_7c2e9a1f4b8d30c65e1a9f27/enrollments/aen_2d8f1b6c9e3a47d05b1c8e62/exit" -H "$AUTH"{ "object": "automation_enrollment", "id": "aen_2d8f1b6c9e3a47d05b1c8e62", "automationId": "aut_7c2e9a1f4b8d30c65e1a9f27", "version": 2, "contact": { "id": "5b0e7c1a-2f4d-4c8b-9a36-1e7d0c5f8b24", "email": "[email protected]", "name": "Ana Lima" }, "status": "active", "source": "trigger", "stepKey": "pause", "waiting": true, "waitingForEvent": null, "heldFor": null, "nextRunAt": "2026-10-14T08:02:11.000Z", "exitReason": null, "lastError": null, "startedAt": "2026-10-11T08:02:03.000Z", "finishedAt": null, "updatedAt": "2026-10-11T08:02:11.000Z"}data에는 값이 이벤트에서 오는 자리에서 단계가 읽을 수 있는 값을 담습니다. 최대 50개 키, JSON 4 KB까지입니다.
연락처가 이미 있어야 합니다. 알 수 없는 주소는 404 contact_not_found로 답합니다.
이미 참여 중인 사람이나, 한 번만 들어올 수 있는 자동화를 이미 거친 사람은 409 already_enrolled로 거부됩니다.
수신 거부했거나, 반송되었거나, 스팸 신고를 한 연락처는 409 contact_unreachable로 거부됩니다.
게시 중인 자동화만 사람을 받습니다: 409 automation_not_live.
사람을 내보내면 그 사람의 실행은 removed 사유로 끝납니다. 이미 끝난 참여 내역은 409 automation_enrollment_finished로 답합니다.