beehiiv Developer Documentation

Delete a segment. Deleting the segment does not effect the subscriptions in the segment.

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

publicationIdstringRequiredformat: "^(pub_[0-9a-fA-F\-]+)$"

The prefixed ID of the publication object

segmentIdstringRequiredformat: "^(seg_[0-9a-fA-F\-]+)$"

The prefixed ID of the segment object

No Content

messagestring

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error

$	curl -X DELETE https://api.beehiiv.com/v2/publications/pub_00000000-0000-0000-0000-000000000000/segments/seg_00000000-0000-0000-0000-000000000000 \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{}'

$	curl -X DELETE https://api.beehiiv.com/v2/publications/pub_00000000-0000-0000-0000-000000000000/segments/seg_00000000-0000-0000-0000-000000000000 \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{}'

Delete segment OAuth Scope: segments:write