[Cotlet](https://cotlet.dev/index.md) · [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Use cases](https://cotlet.dev/use-cases.md) · [Security](https://cotlet.dev/security.md) · [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) · [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [Contact](https://cotlet.dev/contact.md) · [Pricing](https://cotlet.dev/pricing.md) · [Sign up](https://cotlet.dev/signup)

# Create a segment

> Create a custom segment from conditions such as Did not open a campaign. Inputs, cURL, Python and Node.js examples and an example response.

Source: https://cotlet.dev/docs/api/privy/create_segment

Docs sections: [Get started](https://cotlet.dev/docs.md) · [REST API](https://cotlet.dev/docs/api.md) · [MCP](https://cotlet.dev/docs/mcp.md) · [SDKs & CLI](https://cotlet.dev/docs/sdks.md) · [Integrations](https://cotlet.dev/docs/integrations.md)

Create a custom segment from conditions such as Did not open a campaign.

Privy API: https://cotlet.dev/docs/api/privy.md

`POST https://cotlet.dev/api/v1/privy/segments`

Access: write.

Creates the segment and returns its id and current mailable_count. Privy cannot edit the conditions of a segment after creation, so a wrong condition means a new segment; a custom segment can be deleted in Contacts > Segments. It reaches no one, so it does not wait for your OK. Campaigns in a "Did not open" condition are listed by their name, not their subject line.

## Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `name` | string | yes | Segment name. Only you see it, contacts do not |
| `match` | string | no | all (Match all, the default) or any (Match any) |
| `conditions` | array | yes | Objects with category, rule and value as in Privy's Choose Category picker, for example Email Engagement, Did not open, and a campaign name |

## Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/privy/segments \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Jane Doe","conditions":"conditions"}'
```

**Python**

```python
result = client.call("privy", "create_segment", {"name":"Jane Doe","conditions":"conditions"})
```

**Node.js**

```js
const result = await cotlet.call('privy', 'create_segment', {"name":"Jane Doe","conditions":"conditions"});
```

**CLI**

```bash
cotlet call privy create_segment --data '{"name":"Jane Doe","conditions":"conditions"}'
```

## Example response

```json
{
  "segment_id": "seg_7d20",
  "name": "Did not open October sale",
  "match": "all",
  "conditions": [
    {
      "category": "Email Engagement",
      "rule": "Did not open",
      "value": "October sale announcement"
    }
  ],
  "mailable_count": 2890
}
```

Previous: [List contacts](https://cotlet.dev/docs/api/privy/list_contacts.md)
Next: [Duplicate a campaign](https://cotlet.dev/docs/api/privy/duplicate_campaign.md)

---

Give your AI agents your signed-in browser.

**Product:** [Integrations](https://cotlet.dev/integrations.md) · [Use cases](https://cotlet.dev/use-cases.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Pricing](https://cotlet.dev/pricing.md) · [Security](https://cotlet.dev/security.md)

**Resources:** [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [GitHub](https://github.com/cotletdev/cotlet)

**Solutions:** [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md)

**Company:** [About](https://cotlet.dev/about.md) · [AI info: company facts](https://cotlet.dev/ai-info.md) · [Contact](https://cotlet.dev/contact.md)

**Legal:** [Terms of service](https://cotlet.dev/terms) · [Privacy policy](https://cotlet.dev/privacy) · [Refund policy](https://cotlet.dev/refunds) · [Acceptable use](https://cotlet.dev/acceptable-use) · [Cookie policy](https://cotlet.dev/cookies) · [DPA](https://cotlet.dev/dpa) · [Subprocessors](https://cotlet.dev/subprocessors)

**Elsewhere:** [Status page](https://status.cotlet.dev) · [Cotlet on GitHub](https://github.com/cotletdev) · [Cotlet on X](https://x.com/cotletdev) · [Cotlet on LinkedIn](https://www.linkedin.com/company/cotletdev) · [Cotlet on Product Hunt](https://www.producthunt.com/products/cotlet) · [Cotlet on Crunchbase](https://www.crunchbase.com/organization/cotlet) · [Cotlet on SaaSHub](https://www.saashub.com/cotlet)

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. [About us](https://cotlet.dev/about.md)

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.