---
"@context": https://schema.org
"@type": TechArticle
"@id": https://www.twilio.com/docs/sendgrid/api-reference/contacts-api-segments#article
headline: Contacts API - Segments
description: Reference for the SendGrid Contacts API Segments endpoints. Create, retrieve, and delete segments to group recipients in your contactdb for targeted email.
url: https://www.twilio.com/docs/sendgrid/api-reference/contacts-api-segments
inLanguage: en
dateModified: 2026-07-02T23:18:59.000Z
author:
  "@type": Organization
  name: Twilio Developer Education Team
publisher:
  "@type": Organization
  name: Twilio
---

# Contacts API - Segments

> \[!WARNING]
>
> This covers the obsolete Legacy Marketing Campaigns API.

> \[!NOTE]
>
> For the most up-to-date information on the Segments API, please visit the [new Marketing Campaigns Segments v2 API](/docs/sendgrid/api-reference/segmenting-contacts-v2).

The Segments API allows you to create and manage segments for your contacts. Segments are used to group contacts based on conditions you set. For example, you might create a segment for contacts who have opened a certain number of your emails, or for contacts who have not opened any of your emails in the last 30 days.
