> ## Documentation Index
> Fetch the complete documentation index at: /help/llms.txt
> Use this file to discover all available pages before exploring further.

# Smart segments

> Save a contact filter for your whole team, use it as a campaign audience that stays up to date, or send it a broadcast.

A **segment** is a saved contact filter, for example **No activity for 90 days** or **Tag customer, has a phone**. Your whole team sees it (saved views in the table stay in your own browser). Who is in a segment is worked out every time you open or use it, so it changes as your contacts do: nobody has to add or remove people by hand.

## Save a segment

**1. Filter your contacts**

Open **Contacts** and use the search, **Filters** (job title, location, company, source, email, phone, in a running campaign, date added, **No activity for**, **Engagement**: **Hot now** or **Any engagement**), a tag or a list.

**2. Click Save as segment**

The button is in the table's toolbar once a filter is on. Give it a name (each segment needs its own) and it is saved for everyone in the workspace. A workspace can have up to 200 segments.

**No activity for** finds people with nothing in their history (no message sent or received, no change) for 30 days, 90 days, 6 months or a year: the same **Last activity** the table shows. It is the filter to use for reactivation campaigns.

To open a segment, click **+ Segment** in the table's toolbar and pick it: its filters are put back on and its name shows as a chip. If you change the filters, **Update "name"** saves the change to that segment and **Save as segment** saves a new one.

## Manage segments

![Contacts > Segments, with three segments, one kept in sync with a campaign](https://mintcdn.com/kerux-f37add41/-FJtcSNgMiq_E0RE/images/segments.png?fit=max\&auto=format\&n=-FJtcSNgMiq_E0RE\&q=85\&s=2c4d916453675ac0bf51dd0bc9cab595)

**Contacts > Segments** lists them with how many contacts are in each right now, their filters in words, and the campaigns that keep adding their people. From there you can **Open** one, start a **Broadcast** to it, **Rename** it or delete it (its contacts stay). A segment that a campaign keeps in sync can't be deleted until you remove that campaign's **Matches a segment** trigger.

## Use a segment as a campaign's audience

**1. Add contacts**

In the campaign, click **Add contacts** and choose **From a segment**, then the segment.

**2. Keep it in sync (optional)**

Tick **Also add people who match later**. Kerux checks every 10 minutes and adds each new person who matches, once. This adds the campaign's **Matches a segment** trigger, shown in its **Triggers** tab, where you can remove it.

Everyone enters a campaign once: someone who leaves the segment and matches it again later isn't added a second time, even with **Allow re-entry** on in the campaign's [Settings](/help/campaigns/campaign-settings.md). The campaign's own rules still apply: limits, working hours, the do-not-contact list and [Sending rules and consent](/help/campaigns/sending-rules-and-consent.md).

You can also add the **Matches a segment** trigger yourself, see [Start a campaign from what happens in Kerux](/help/campaigns/kerux-triggers.md).

## Send one message to a segment

Use a [broadcast](/help/campaigns/broadcasts.md): one message on LinkedIn, email or WhatsApp, now or at a time.

## API

The [public API](/help/developers/api.md) has the same segments: `GET` and `POST /v1/segments`, `GET`, `PATCH` and `DELETE /v1/segments/{id}`, `GET /v1/segments/{id}/leads` (the contacts in it now) and `POST /v1/segments/count` (how many contacts some filters match). `GET /v1/leads` also takes `has_phone`, `added_within_days` and `quiet_days`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.