Skip to main content
DELETE
Remove static segment members
Removes one or more contacts from a static segment by email.

Path parameters

  • id (string, required): Segment ID

Request body

  • emails must be a non-empty array of valid email addresses.
  • Maximum length is 500 emails per request.

Response

  • removed: Number of provided emails that matched contacts in the workspace.

Notes

  • This endpoint only works for STATIC segments.
  • Calling it for a DYNAMIC segment returns 400.

Authorizations

Authorization
string
header
required

API Key authentication. Secret keys (sk_*) are required for all endpoints except /v1/track. Public keys (pk_*) only work with the /v1/track endpoint for client-side event tracking. Workspaces can have multiple active keys, and sender-domain operations enforce per-key domain scope when configured.

Path Parameters

id
string
required

Body

application/json
emails
string<email>[]
required
Required array length: 1 - 500 elements

Response

Contacts removed from static segment

removed
integer