> For the complete documentation index, see [llms.txt](https://docs.shoplift.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.shoplift.ai/api-reference/public-api/list-klaviyo-segments-and-lists.md).

# List Klaviyo segments and lists

Returns the Klaviyo segments and lists synced from the store's connected Klaviyo account. Use a segment's token in a klaviyoSegment rule, and a list's in a klaviyoList rule, when creating a custom audience. Groups since deleted in Klaviyo are included with deleted: true, so an existing rule still resolves to a name. Requires the Klaviyo integration; without it, returns 403.

```json
{"openapi":"3.1.1","info":{"title":"Shoplift Public API","version":"1.0.0"},"tags":[{"name":"Public API"}],"servers":[{"url":"https://app.shoplift.ai"}],"security":[{"ApiKey":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"http","description":"All requests require `Authorization: Bearer sl_live_<your_api_key>`. Generate a key from the Shoplift admin's API Keys settings page.","scheme":"bearer"}},"schemas":{"ExternalKlaviyoGroupsResponse":{"required":["klaviyoGroups","lastSyncAt"],"type":"object","properties":{"klaviyoGroups":{"type":"array","items":{"$ref":"#/components/schemas/ExternalKlaviyoGroupItem"}},"lastSyncAt":{"type":["null","string"],"format":"date-time"}}},"ExternalKlaviyoGroupItem":{"required":["token","kind","name","deleted"],"type":"object","properties":{"token":{"type":"string"},"kind":{"type":"string"},"name":{"type":"string"},"deleted":{"type":"boolean"}}},"ProblemDetails":{"type":"object","properties":{"type":{"type":["null","string"]},"title":{"type":["null","string"]},"status":{"type":["null","integer"],"format":"int32"},"detail":{"type":["null","string"]},"instance":{"type":["null","string"]}}}}},"paths":{"/api/public/v1/klaviyo-groups":{"get":{"tags":["Public API"],"summary":"List Klaviyo segments and lists","description":"Returns the Klaviyo segments and lists synced from the store's connected Klaviyo account. Use a segment's token in a klaviyoSegment rule, and a list's in a klaviyoList rule, when creating a custom audience. Groups since deleted in Klaviyo are included with deleted: true, so an existing rule still resolves to a name. Requires the Klaviyo integration; without it, returns 403.","operationId":"listKlaviyoGroups","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalKlaviyoGroupsResponse"}}}},"403":{"description":"Forbidden","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"429":{"description":"Too Many Requests","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}}}}}}
```