Skip to content

이메일 구독 상태 변경

post

/email/status

이 엔드포인트를 사용하여 사용자의 이메일 구독 상태를 설정할 수 있습니다.

사용자는 opted_in, unsubscribed 또는 subscribed(명시적으로 옵트인 또는 옵트아웃하지 않은 상태)일 수 있습니다.

Braze 내에서 아직 사용자와 연결되지 않은 이메일 주소의 이메일 구독 상태를 설정할 수 있습니다. 나중에 해당 이메일 주소가 사용자와 연결되면 업로드한 이메일 구독 상태가 자동으로 설정됩니다.

필수 조건

이 엔드포인트를 사용하려면 email.status 권한이 있는 API 키가 필요합니다.

사용량 제한

이 엔드포인트에는 API 사용량 제한 설명서에 명시된 대로 기본 Braze 사용량 제한인 시간당 250,000건의 요청이 적용됩니다.

요청 본문

1
2
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY
1
2
3
4
{
  "email": "[email protected]",
  "subscription_state": "subscribed"
}

요청 매개변수

매개변수 필수 데이터 유형 설명
email 필수 문자열 또는 배열 수정할 이메일 주소를 문자열로 입력하거나, 수정할 이메일 주소를 최대 50개까지 배열로 입력할 수 있습니다.
subscription_state 필수 문자열 “subscribed”, “unsubscribed” 또는 “opted_in” 중 하나입니다.

요청 예시

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": "[email protected]",
  "subscription_state": "subscribed"
}'
New Stuff!