OMomnisend
Segments

Delete segment

Permanently deletes a segment by its unique identifier. The segment must not be in a building state to be deleted. If the segment is currently being built, a 409 Conflict error is returned.

Scopes: segments.write

Rate Limiting: This endpoint is rate limited to 100 requests per minute.

delete/segments/{segmentID}

Request

  • Base URL
    https://api.omnisend.com/api
  • URL
    https://api.omnisend.com/api/segments/{segmentID}
  • Auth
    • OAuth 2
      Client credentials
      Token URL: https://app.omnisend.com/oauth2/token scopes: segments.write
    • or API key in header Authorization

Path parameters

segmentIDstring required

Segment ID

Headers

Omnisend-Versionstring required

API version that specifies the response format and behaviour (e.g., 2026-preview)

Response

No Content

Changes

No recorded changes to this operation across all 1 revision of this API.