이메일 구독 상태 변경
이 엔드포인트를 사용하여 사용자의 이메일 구독 상태를 설정할 수 있습니다.
사용자는 opted_in
, unsubscribed
, 또는 subscribed
(특별히 옵트인 또는 옵트아웃하지 않음)일 수 있습니다.
Braze 내에서 아직 사용자와 연결되지 않은 이메일 주소의 이메일 구독 상태를 설정할 수 있습니다. 나중에 해당 이메일 주소가 사용자와 연결되면 업로드한 이메일 구독 상태가 자동으로 설정됩니다.
필수 구성 요소
이 엔드포인트를 사용하려면 email.status
권한이 있는 API 키가 필요합니다.
사용량 제한
요청 본문
1
2
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY
1
2
3
4
{
"email": "example@braze.com",
"subscription_state": "subscribed"
}
요청 매개변수
매개변수 | 필수 | 데이터 유형 | 설명 |
---|---|---|---|
email |
필수 | 문자열 또는 배열 | 수정할 이메일 주소를 문자열로 입력하거나 수정할 이메일 주소를 최대 50개까지 배열할 수 있습니다. |
subscription_state |
필수 | 문자열 | “구독”, “구독 취소” 또는 “옵트인” 중 하나를 선택합니다. |
요청 예시
1
2
3
4
5
6
7
curl --location --request POST 'https://rest.iad-01.braze.com/email/status' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-API-KEY-HERE' \
--data-raw '{
"email": "example@braze.com",
"subscription_state": "subscribed"
}'
New Stuff!