Menu

Delete segment

The Segmentation v2 API is in public beta. Creating and editing v2 segments is available through the API only at this time.

You can see the v2 segments you have created with their contacts in the UI, but the details of a segment and the ability to edit a segment will not be displayed. In the UI, both V1 and V2 segments can be exported and as an audience for a Single Send or Automation.

Delete segment

DELETE /marketing/segments/2.0/{segment_id}

The Segmentation V2 API is currently in private beta. If you'd like to be added to the beta, please fill out this form

Authentication

  • API Key

Headers

Authorization
string
default: Bearer <<YOUR_API_KEY_HERE>>
required

Path Parameters

segment_id
string
default: None
required

Responses

No response body.
object

If the request is incorrect, an array of errors will be returned.

errors
array[object]
required
field
string

the field in the request body that is incorrect

message
string

a description of what is specifically wrong with the field passed in the request

No response body.
object

If the request is incorrect, an array of errors will be returned.

errors
array[object]
required
field
string

the field in the request body that is incorrect

message
string

a description of what is specifically wrong with the field passed in the request

Rate this page:

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the SendGrid tag on Stack Overflow.

Thank you for your feedback!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

Sending your feedback...
🎉 Thank you for your feedback!
Something went wrong. Please try again.

Thanks for your feedback!

Refer us and get $10 in 3 simple steps!

Step 1

Get link

Get a free personal referral link here

Step 2

Give $10

Your user signs up and upgrade using link

Step 3

Get $10

1,250 free SMSes
OR 1,000 free voice mins
OR 12,000 chats
OR more