A key generated from Settings → Developers, sent as
Authorization: Bearer dr_live_<12 hex chars>_<64 hex chars>. Keys
carry explicit scopes — each endpoint states the one it requires.
The full key is shown exactly once at generation time and cannot be
retrieved again; only the keyId prefix is shown afterward. A
revoked key fails auth on its very next request.
The rule that decides who is in a group. A contact is in the group when it
matches conditions (joined by operator), matches every condition in
requiredConditions, and matches none of excludeConditions. Each list holds
at most 20 conditions, and at least one condition is needed across the three
lists (otherwise 422 EMPTY_FILTER). Unsubscribed contacts are never members.
See Group conditions.
Show child attributes
Response
The group was created. memberCount is the live count at creation.
A group with its rule and its live member count. Never any member data.
A saved rule exactly as it is stored, which is what GET /api/preview/segments/{id}
returns. Unlike GroupFilter (what you may send) it has no limit on the length of a
list, and its conditions can be of any type (StoredGroupCondition), because a saved group is not held to the API's rules. A group
stored without a rule comes back as {}.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"DocuRise Developer Docs","colors":{"primary":"#DA350B","light":"#FF3C00","dark":"#AE2D13"},"logo":"https://mintcdn.com/docu-rise/ClhhLqgPXOXvt7Zz/logo.png?fit=max\u0026auto=format\u0026n=ClhhLqgPXOXvt7Zz\u0026q=85\u0026s=b73379a7630a12945d164a128a6ddb12","favicon":"https://mintcdn.com/docu-rise/uxv1U4cKVTA4xM3l/favicon.png?fit=max\u0026auto=format\u0026n=uxv1U4cKVTA4xM3l\u0026q=85\u0026s=0b88e688751814cb08931184873ba0be","appearance":{"default":"light","strict":true},"navbar":{"primary":{"type":"button","label":"Dashboard","href":"https://docurise.io/dashboard"}},"footer":{"socials":{}},"styling":{"latex":false},"navigation":{"languages":[{"language":"en","href":""},{"language":"ko","href":"ko"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"docu-rise","hasAudioNarration":false,"actualSubdomain":"docu-rise","customDomains":["docurise.io"],"gitSource":{"type":"github","owner":"ireneshlee814","repo":"docurise","deployBranch":"master","contentDirectory":"docs-content","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6adf1a4ed7cf896c8ad7ba87","collectionId":"94de5c8f-93e4-44a5-af98-0fc3dd32e1b8","liveDeploymentHistoryId":"6adf1a4ed7cf896c8ad7ba87","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6adf7b89b80f21f061134342","clientVersion":"0.0.3966","searchFilterCounts":[{"language":"en","tag":"API Reference","count":27},{"language":"ko","tag":"API Reference","count":27},{"language":"en","tag":"Documents","count":8},{"language":"ko","tag":"문서","count":8},{"language":"en","tag":"Audiences","count":7},{"language":"en","tag":"Guides","count":7},{"language":"ko","tag":"오디언스","count":7},{"language":"ko","tag":"가이드","count":7},{"language":"en","tag":"Instagram","count":4},{"language":"ko","tag":"Instagram","count":4},{"language":"en","tag":"Email","count":3},{"language":"en","tag":"Get Started","count":3},{"language":"ko","tag":"이메일","count":3},{"language":"ko","tag":"시작하기","count":3},{"language":"en","tag":"Contacts","count":2},{"language":"en","tag":"Reference","count":2},{"language":"en","tag":"AI Apps","count":2},{"language":"ko","tag":"연락처","count":2},{"language":"ko","tag":"레퍼런스","count":2},{"language":"ko","tag":"AI 앱","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/create-segment","slug":"/api-reference/create-segment","pageMetadata":{"title":"Create a group","description":"Create one group from a rule; an Idempotency-Key makes retries safe","openapi":"api-reference/openapi.yaml POST /api/preview/segments","href":"/api-reference/create-segment"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Create one group from a rule; an Idempotency-Key makes retries safe\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create a group","description":"Create one group from a rule; an Idempotency-Key makes retries safe","openapi":"api-reference/openapi.yaml POST /api/preview/segments","href":"/api-reference/create-segment"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"createSegment","tags":["Audiences"],"summary":"Create a group","description":"Create one group from a rule; an Idempotency-Key makes retries safe","security":["6d0f2653-1aeb-4278-9084-017dd127ec0f"],"parameters":["7e45f3d0-0357-4750-a599-c9b2ce9a66df"],"requestBody":"970c8200-cbbd-435d-84b3-59c983531c97","responses":{"201":"f7466690-e70a-44f1-9313-422c20136dd5","400":"42f82308-d111-41db-9232-d2050dcdbe84","401":"60a9453c-68d2-48af-a3af-1649f7fa879e","403":"a13a5fd8-fe38-4c19-96d0-3391684cd832","404":"aeebf2f2-7da9-4983-97c6-a64c226431dd","409":"27ec1e3e-f736-499d-a031-ecf350f9528c","422":"17bbe621-b9fd-4794-8630-c13f2c223d00","429":"0b4a8741-63b8-4ee0-83c2-daf624e0f6f1","500":"baac1a39-675c-4601-a097-3802dd7d2316","503":"8e418044-381e-41f2-b410-c905f8419dbd"},"x-codeSamples":[{"lang":"bash","label":"curl","source":"curl -X POST 'https://docurise.io/api/preview/segments' \\\n -H 'Authorization: Bearer dr_live_\u003ckeyId>_\u003csecret>' \\\n -H 'Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000' \\\n -H 'Content-Type: application/json' \\\n -d '{\n \"name\": \"Newsletter readers, still active\",\n \"filter\": {\n \"operator\": \"AND\",\n \"conditions\": [{ \"field\": \"tag\", \"operator\": \"has\", \"value\": \"newsletter\" }],\n \"requiredConditions\": [{ \"field\": \"consent\", \"operator\": \"active\" }],\n \"excludeConditions\": [{ \"field\": \"last_active\", \"operator\": \"inactive_for_days\", \"value\": 90 }]\n }\n }'\n"}],"method":"post","type":"path","servers":["7304e0b3-d967-42dc-a414-a807932689bf"],"path":"/api/preview/segments","baseUrlOptions":["https://docurise.io"],"title":"Create a group","codeSamples":[{"label":"curl","lang":"bash","source":"curl -X POST 'https://docurise.io/api/preview/segments' \\\n -H 'Authorization: Bearer dr_live_\u003ckeyId>_\u003csecret>' \\\n -H 'Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000' \\\n -H 'Content-Type: application/json' \\\n -d '{\n \"name\": \"Newsletter readers, still active\",\n \"filter\": {\n \"operator\": \"AND\",\n \"conditions\": [{ \"field\": \"tag\", \"operator\": \"has\", \"value\": \"newsletter\" }],\n \"requiredConditions\": [{ \"field\": \"consent\", \"operator\": \"active\" }],\n \"excludeConditions\": [{ \"field\": \"last_active\", \"operator\": \"inactive_for_days\", \"value\": 90 }]\n }\n }'\n"}],"requiredOnlyExamples":false,"requestExampleType":"codeSamples","responseExampleType":"generated"},"dependencies":{"parameters":{"7e45f3d0-0357-4750-a599-c9b2ce9a66df":{"name":"Idempotency-Key","in":"header","required":true,"description":"A unique client-generated string (≤ 255 characters) identifying this create attempt. See \"Idempotency\" above.","schema":{"type":"string","maxLength":255,"isRequired":true,"description":"A unique client-generated string (≤ 255 characters) identifying this create attempt. See \"Idempotency\" above.","uniqueKey":"","typeLabel":"string"},"example":"550e8400-e29b-41d4-a716-446655440000"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name","filter"],"additionalProperties":false,"properties":{"name":{"type":"string","minLength":1,"maxLength":100,"description":"The group name. It is trimmed and Unicode-normalized (NFC), then must be 1-100 characters and must not contain a NUL character. Names are not unique.","example":"Newsletter readers, still active","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"filter":{"type":"object","required":["operator","conditions"],"additionalProperties":false,"description":"The rule that decides who is in a group. A contact is in the group when it\nmatches `conditions` (joined by `operator`), matches every condition in\n`requiredConditions`, and matches none of `excludeConditions`. Each list holds\nat most 20 conditions, and at least one condition is needed across the three\nlists (otherwise `422 EMPTY_FILTER`). Unsubscribed contacts are never members.\nSee [Group conditions](/api-reference/group-conditions).\n","properties":{"operator":{"type":"string","enum":["AND","OR"],"description":"How the conditions in `conditions` are joined, `AND` (all of them) or `OR` (any of them).","isRequired":true,"uniqueKey":"filter.operator","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","maxItems":20,"items":{"type":"object","required":["field"],"additionalProperties":true,"description":"One condition of a rule: an object whose required `field` names the condition\ntype, plus the keys that type takes (for example `operator` and `value`). The\n20 types, their keys and allowed values, and where to find the ids they need\nare on [Group conditions](/api-reference/group-conditions); this schema lists\nonly `field` so the two cannot disagree. The server validates every condition\nstrictly: an unknown key, a wrong value or a combination of keys the type does\nnot allow is a `400 VALIDATION_ERROR` naming the path. A `custom_field`\ncondition is refused with `422 CONDITION_NOT_SUPPORTED`, and so are the few\ncondition shapes that give a wrong answer for some contacts in the list they\nare in (see Group conditions).\n","properties":{"field":{"type":"string","enum":["tag","document_view","consent","cta_click","email_open","email_link_click","has_phone","form_submission","payment_status","first_seen","last_active","group_membership","tier_access","days_since_purchase","repeat_bounce","course_last_access","kakao_reachable","course_progress","location","checkout_abandoned"],"description":"The condition type.","isRequired":true,"uniqueKey":"filter.conditions.items.[INDEX].field","typeLabel":"enum\u003cstring>"}},"example":{"field":"tag","operator":"has","value":"newsletter"},"uniqueKey":"filter.conditions.items.[INDEX]","typeLabel":"object"},"description":"The main list of conditions. May be empty when `requiredConditions` or `excludeConditions` has some.","isRequired":true,"uniqueKey":"filter.conditions","typeLabel":"object[]"},"requiredConditions":{"type":"array","maxItems":20,"items":{"type":"object","required":["field"],"additionalProperties":true,"description":"One condition of a rule: an object whose required `field` names the condition\ntype, plus the keys that type takes (for example `operator` and `value`). The\n20 types, their keys and allowed values, and where to find the ids they need\nare on [Group conditions](/api-reference/group-conditions); this schema lists\nonly `field` so the two cannot disagree. The server validates every condition\nstrictly: an unknown key, a wrong value or a combination of keys the type does\nnot allow is a `400 VALIDATION_ERROR` naming the path. A `custom_field`\ncondition is refused with `422 CONDITION_NOT_SUPPORTED`, and so are the few\ncondition shapes that give a wrong answer for some contacts in the list they\nare in (see Group conditions).\n","properties":{"field":{"type":"string","enum":["tag","document_view","consent","cta_click","email_open","email_link_click","has_phone","form_submission","payment_status","first_seen","last_active","group_membership","tier_access","days_since_purchase","repeat_bounce","course_last_access","kakao_reachable","course_progress","location","checkout_abandoned"],"description":"The condition type.","isRequired":true,"uniqueKey":"filter.requiredConditions.items.[INDEX].field","typeLabel":"enum\u003cstring>"}},"example":{"field":"tag","operator":"has","value":"newsletter"},"uniqueKey":"filter.requiredConditions.items.[INDEX]","typeLabel":"object"},"description":"Conditions every member must also match. Always AND-ed in, whatever `operator` is.","uniqueKey":"filter.requiredConditions","typeLabel":"object[]"},"excludeConditions":{"type":"array","maxItems":20,"items":{"type":"object","required":["field"],"additionalProperties":true,"description":"One condition of a rule: an object whose required `field` names the condition\ntype, plus the keys that type takes (for example `operator` and `value`). The\n20 types, their keys and allowed values, and where to find the ids they need\nare on [Group conditions](/api-reference/group-conditions); this schema lists\nonly `field` so the two cannot disagree. The server validates every condition\nstrictly: an unknown key, a wrong value or a combination of keys the type does\nnot allow is a `400 VALIDATION_ERROR` naming the path. A `custom_field`\ncondition is refused with `422 CONDITION_NOT_SUPPORTED`, and so are the few\ncondition shapes that give a wrong answer for some contacts in the list they\nare in (see Group conditions).\n","properties":{"field":{"type":"string","enum":["tag","document_view","consent","cta_click","email_open","email_link_click","has_phone","form_submission","payment_status","first_seen","last_active","group_membership","tier_access","days_since_purchase","repeat_bounce","course_last_access","kakao_reachable","course_progress","location","checkout_abandoned"],"description":"The condition type.","isRequired":true,"uniqueKey":"filter.excludeConditions.items.[INDEX].field","typeLabel":"enum\u003cstring>"}},"example":{"field":"tag","operator":"has","value":"newsletter"},"uniqueKey":"filter.excludeConditions.items.[INDEX]","typeLabel":"object"},"description":"Conditions that remove contacts. A contact matching any one of them is left out. A few condition shapes are refused here (`422 CONDITION_NOT_SUPPORTED`); see [Group conditions](/api-reference/group-conditions).","uniqueKey":"filter.excludeConditions","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"filter","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"name":"Newsletter readers, still active","filter":{"operator":"AND","conditions":[{"field":"tag","operator":"has","value":"newsletter"}],"requiredConditions":[{"field":"consent","operator":"active"}],"excludeConditions":[{"field":"last_active","operator":"inactive_for_days","value":90}]}},"examples":{"Example":{"title":"Example","value":{"name":"Newsletter readers, still active","filter":{"operator":"AND","conditions":[{"field":"tag","operator":"has","value":"newsletter"}],"requiredConditions":[{"field":"consent","operator":"active"}],"excludeConditions":[{"field":"last_active","operator":"inactive_for_days","value":90}]}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"f7466690-e70a-44f1-9313-422c20136dd5":{"description":"The group was created. `memberCount` is the live count at creation.","content":{"application/json":{"schema":{"type":"object","required":["id","name","filter","memberCount","createdAt"],"description":"A group with its rule and its live member count. Never any member data.","properties":{"id":{"type":"string","format":"uuid","description":"The group id.","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","description":"The group name.","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"filter":{"type":"object","additionalProperties":true,"description":"A saved rule exactly as it is stored, which is what `GET /api/preview/segments/{id}`\nreturns. Unlike `GroupFilter` (what you may send) it has no limit on the length of a\nlist, and its conditions can be of any type (`StoredGroupCondition`), because a saved group is not held to the API's rules. A group\nstored without a rule comes back as `{}`.\n","properties":{"operator":{"type":"string","enum":["AND","OR"],"description":"How the conditions in `conditions` are joined, `AND` (all of them) or `OR` (any of them).","uniqueKey":"filter.operator","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"type":"object","required":["field"],"additionalProperties":true,"description":"One condition of a saved rule, as it is stored. Unlike `GroupCondition` (what you\nmay send), `field` can be any condition type, including `custom_field`, which the API cannot create. The keys of each type are on\n[Group conditions](/api-reference/group-conditions).\n","properties":{"field":{"type":"string","description":"The condition type. One of the 20 types on Group conditions, or `custom_field`.","isRequired":true,"uniqueKey":"filter.conditions.items.[INDEX].field","typeLabel":"string"}},"example":{"field":"custom_field","questionId":"q9f2k1x7ab","operator":"exists"},"uniqueKey":"filter.conditions.items.[INDEX]","typeLabel":"object"},"description":"The main list of conditions.","uniqueKey":"filter.conditions","typeLabel":"object[]"},"requiredConditions":{"type":"array","items":{"type":"object","required":["field"],"additionalProperties":true,"description":"One condition of a saved rule, as it is stored. Unlike `GroupCondition` (what you\nmay send), `field` can be any condition type, including `custom_field`, which the API cannot create. The keys of each type are on\n[Group conditions](/api-reference/group-conditions).\n","properties":{"field":{"type":"string","description":"The condition type. One of the 20 types on Group conditions, or `custom_field`.","isRequired":true,"uniqueKey":"filter.requiredConditions.items.[INDEX].field","typeLabel":"string"}},"example":{"field":"custom_field","questionId":"q9f2k1x7ab","operator":"exists"},"uniqueKey":"filter.requiredConditions.items.[INDEX]","typeLabel":"object"},"description":"Conditions every member must also match.","uniqueKey":"filter.requiredConditions","typeLabel":"object[]"},"excludeConditions":{"type":"array","items":{"type":"object","required":["field"],"additionalProperties":true,"description":"One condition of a saved rule, as it is stored. Unlike `GroupCondition` (what you\nmay send), `field` can be any condition type, including `custom_field`, which the API cannot create. The keys of each type are on\n[Group conditions](/api-reference/group-conditions).\n","properties":{"field":{"type":"string","description":"The condition type. One of the 20 types on Group conditions, or `custom_field`.","isRequired":true,"uniqueKey":"filter.excludeConditions.items.[INDEX].field","typeLabel":"string"}},"example":{"field":"custom_field","questionId":"q9f2k1x7ab","operator":"exists"},"uniqueKey":"filter.excludeConditions.items.[INDEX]","typeLabel":"object"},"description":"Conditions that remove contacts.","uniqueKey":"filter.excludeConditions","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"filter","typeLabel":"object"},"memberCount":{"type":"integer","minimum":0,"description":"The live number of contacts in the group now (never unsubscribed contacts). A count only; the contacts themselves are never returned.","isRequired":true,"uniqueKey":"memberCount","typeLabel":"integer"},"createdAt":{"type":"string","format":"date-time","description":"When the group was created, RFC 3339 in UTC.","isRequired":true,"uniqueKey":"createdAt","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"","typeLabel":"object"},"example":{"id":"3d2b8a64-5e0f-4c71-b9a2-1f7e6c4d8a05","name":"Newsletter readers, still active","filter":{"operator":"AND","conditions":[{"field":"tag","operator":"has","value":"newsletter"}],"requiredConditions":[{"field":"consent","operator":"active"}],"excludeConditions":[{"field":"last_active","operator":"inactive_for_days","value":90}]},"memberCount":124,"createdAt":"2026-10-22T03:14:15.926Z"},"examples":{"Example":{"title":"Example","value":{"id":"3d2b8a64-5e0f-4c71-b9a2-1f7e6c4d8a05","name":"Newsletter readers, still active","filter":{"operator":"AND","conditions":[{"field":"tag","operator":"has","value":"newsletter"}],"requiredConditions":[{"field":"consent","operator":"active"}],"excludeConditions":[{"field":"last_active","operator":"inactive_for_days","value":90}]},"memberCount":124,"createdAt":"2026-10-22T03:14:15.926Z"}}},"exampleType":"examples"}},"exampleType":"examples"},"42f82308-d111-41db-9232-d2050dcdbe84":{"description":"`INVALID_JSON` (the body is not JSON), `IDEMPOTENCY_KEY_REQUIRED`,\n`IDEMPOTENCY_KEY_TOO_LONG` or `VALIDATION_ERROR` (a bad `name` or\n`filter`; `message` starts with the path of the bad part, for example\n`name:` or `filter.conditions.2.value:`. Causes include a missing or\nempty `name`, a name over 100 characters, a NUL character, an unknown\nkey in the body, the rule or a condition, a wrong value or type, a list\nof more than 20 conditions, an id that is not a UUID, and a combination\nof keys a condition does not allow).\n","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","retryable"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code — switch on this, not `message`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable detail. May change wording without notice.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","description":"Whether retrying the identical request may succeed.","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"retryAfterSeconds":{"type":"integer","description":"Present only when a concrete backoff hint applies.","uniqueKey":"error.retryAfterSeconds","typeLabel":"integer"},"details":{"type":"object","description":"Present only for a few specific codes:\n- `PROTECTION_RULE_CONFLICT`: `{ rule: string }`, the protection rule that refused the request\n (`form`, `restricted_access`, `paid_lead_gate`, `free_lead_gate` or `form_no_access_controls`).\n Open-ended: tolerate new values.\n- `NEXT_POST_RULE_EXISTS`: `{ ruleId: string }`, the existing next-post rule.\n- `NOTION_FETCH_FAILED`: `{ notionErrorCode: string }`, one of\n `NOTION_ERROR_PRIVATE`, `NOTION_ERROR_NOT_FOUND`,\n `NOTION_ERROR_NETWORK`, `NOTION_ERROR_RATE_LIMIT`,\n `NOTION_ERROR_TEMPORARILY_UNAVAILABLE`,\n `NOTION_ERROR_PAGE_REJECTED`, `NOTION_ERROR_UNKNOWN`.\n- `HTML_REJECTED`: `{ reason: string }`, one of `too_large`, `css_rejected` or `invalid`.\n Open-ended: tolerate new values.\n- `CONDITION_NOT_SUPPORTED`: `{ field: string, path: string }`, the condition type that is not\n accepted and where it sits in the request. For a condition shape refused where it sits\n also `operator: string` and, when there is an equivalent operator for `requiredConditions`,\n `invertTo: string`.\n- `REFERENCE_NOT_FOUND`: `{ path: string, kind: string }`, where the unknown id sits in the\n request and what it refers to: `document`, `product`, `tier`, `cta`, `folder`, `broadcast` or\n `step`. Open-ended: tolerate new values.\n- `TAG_NOT_FOUND` (from a group rule): `{ tag: string }`, the tag name that does not exist.\n- `GROUP_REFERENCE_NOT_FOUND`: `{ groupIds: string[] }`, the group ids that are not in the account.\n- `GROUP_LIMIT_REACHED`: `{ limit: integer }`, the most groups an account can create through the API.\n","uniqueKey":"error.details","typeLabel":"object"}},"description":"The error. Every error response from the API has it: `code`, `message`, `retryable` and, for some codes, `retryAfterSeconds` and `details`.","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"VALIDATION_ERROR","message":"filter.conditions.0.value: Number must be less than or equal to 365","retryable":false}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"VALIDATION_ERROR","message":"filter.conditions.0.value: Number must be less than or equal to 365","retryable":false}}}},"exampleType":"examples"}},"exampleType":"examples"},"60a9453c-68d2-48af-a3af-1649f7fa879e":{"description":"Missing, malformed, or revoked API key (`code: UNAUTHORIZED`).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","retryable"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code — switch on this, not `message`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable detail. May change wording without notice.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","description":"Whether retrying the identical request may succeed.","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"retryAfterSeconds":{"type":"integer","description":"Present only when a concrete backoff hint applies.","uniqueKey":"error.retryAfterSeconds","typeLabel":"integer"},"details":{"type":"object","description":"Present only for a few specific codes:\n- `PROTECTION_RULE_CONFLICT`: `{ rule: string }`, the protection rule that refused the request\n (`form`, `restricted_access`, `paid_lead_gate`, `free_lead_gate` or `form_no_access_controls`).\n Open-ended: tolerate new values.\n- `NEXT_POST_RULE_EXISTS`: `{ ruleId: string }`, the existing next-post rule.\n- `NOTION_FETCH_FAILED`: `{ notionErrorCode: string }`, one of\n `NOTION_ERROR_PRIVATE`, `NOTION_ERROR_NOT_FOUND`,\n `NOTION_ERROR_NETWORK`, `NOTION_ERROR_RATE_LIMIT`,\n `NOTION_ERROR_TEMPORARILY_UNAVAILABLE`,\n `NOTION_ERROR_PAGE_REJECTED`, `NOTION_ERROR_UNKNOWN`.\n- `HTML_REJECTED`: `{ reason: string }`, one of `too_large`, `css_rejected` or `invalid`.\n Open-ended: tolerate new values.\n- `CONDITION_NOT_SUPPORTED`: `{ field: string, path: string }`, the condition type that is not\n accepted and where it sits in the request. For a condition shape refused where it sits\n also `operator: string` and, when there is an equivalent operator for `requiredConditions`,\n `invertTo: string`.\n- `REFERENCE_NOT_FOUND`: `{ path: string, kind: string }`, where the unknown id sits in the\n request and what it refers to: `document`, `product`, `tier`, `cta`, `folder`, `broadcast` or\n `step`. Open-ended: tolerate new values.\n- `TAG_NOT_FOUND` (from a group rule): `{ tag: string }`, the tag name that does not exist.\n- `GROUP_REFERENCE_NOT_FOUND`: `{ groupIds: string[] }`, the group ids that are not in the account.\n- `GROUP_LIMIT_REACHED`: `{ limit: integer }`, the most groups an account can create through the API.\n","uniqueKey":"error.details","typeLabel":"object"}},"description":"The error. Every error response from the API has it: `code`, `message`, `retryable` and, for some codes, `retryAfterSeconds` and `details`.","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","retryable":true,"retryAfterSeconds":123,"details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"a13a5fd8-fe38-4c19-96d0-3391684cd832":{"description":"`PAST_DUE_RESTRICTED`, `PLAN_REQUIRED` or `INSUFFICIENT_SCOPE` (the key lacks `segments:write`).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","retryable"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code — switch on this, not `message`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable detail. May change wording without notice.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","description":"Whether retrying the identical request may succeed.","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"retryAfterSeconds":{"type":"integer","description":"Present only when a concrete backoff hint applies.","uniqueKey":"error.retryAfterSeconds","typeLabel":"integer"},"details":{"type":"object","description":"Present only for a few specific codes:\n- `PROTECTION_RULE_CONFLICT`: `{ rule: string }`, the protection rule that refused the request\n (`form`, `restricted_access`, `paid_lead_gate`, `free_lead_gate` or `form_no_access_controls`).\n Open-ended: tolerate new values.\n- `NEXT_POST_RULE_EXISTS`: `{ ruleId: string }`, the existing next-post rule.\n- `NOTION_FETCH_FAILED`: `{ notionErrorCode: string }`, one of\n `NOTION_ERROR_PRIVATE`, `NOTION_ERROR_NOT_FOUND`,\n `NOTION_ERROR_NETWORK`, `NOTION_ERROR_RATE_LIMIT`,\n `NOTION_ERROR_TEMPORARILY_UNAVAILABLE`,\n `NOTION_ERROR_PAGE_REJECTED`, `NOTION_ERROR_UNKNOWN`.\n- `HTML_REJECTED`: `{ reason: string }`, one of `too_large`, `css_rejected` or `invalid`.\n Open-ended: tolerate new values.\n- `CONDITION_NOT_SUPPORTED`: `{ field: string, path: string }`, the condition type that is not\n accepted and where it sits in the request. For a condition shape refused where it sits\n also `operator: string` and, when there is an equivalent operator for `requiredConditions`,\n `invertTo: string`.\n- `REFERENCE_NOT_FOUND`: `{ path: string, kind: string }`, where the unknown id sits in the\n request and what it refers to: `document`, `product`, `tier`, `cta`, `folder`, `broadcast` or\n `step`. Open-ended: tolerate new values.\n- `TAG_NOT_FOUND` (from a group rule): `{ tag: string }`, the tag name that does not exist.\n- `GROUP_REFERENCE_NOT_FOUND`: `{ groupIds: string[] }`, the group ids that are not in the account.\n- `GROUP_LIMIT_REACHED`: `{ limit: integer }`, the most groups an account can create through the API.\n","uniqueKey":"error.details","typeLabel":"object"}},"description":"The error. Every error response from the API has it: `code`, `message`, `retryable` and, for some codes, `retryAfterSeconds` and `details`.","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","retryable":true,"retryAfterSeconds":123,"details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"aeebf2f2-7da9-4983-97c6-a64c226431dd":{"description":"The API is available to some accounts only, whatever the plan. If you\nexpect access, check with your DocuRise contact (`code: NOT_FOUND`).\n","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","retryable"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code — switch on this, not `message`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable detail. May change wording without notice.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","description":"Whether retrying the identical request may succeed.","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"retryAfterSeconds":{"type":"integer","description":"Present only when a concrete backoff hint applies.","uniqueKey":"error.retryAfterSeconds","typeLabel":"integer"},"details":{"type":"object","description":"Present only for a few specific codes:\n- `PROTECTION_RULE_CONFLICT`: `{ rule: string }`, the protection rule that refused the request\n (`form`, `restricted_access`, `paid_lead_gate`, `free_lead_gate` or `form_no_access_controls`).\n Open-ended: tolerate new values.\n- `NEXT_POST_RULE_EXISTS`: `{ ruleId: string }`, the existing next-post rule.\n- `NOTION_FETCH_FAILED`: `{ notionErrorCode: string }`, one of\n `NOTION_ERROR_PRIVATE`, `NOTION_ERROR_NOT_FOUND`,\n `NOTION_ERROR_NETWORK`, `NOTION_ERROR_RATE_LIMIT`,\n `NOTION_ERROR_TEMPORARILY_UNAVAILABLE`,\n `NOTION_ERROR_PAGE_REJECTED`, `NOTION_ERROR_UNKNOWN`.\n- `HTML_REJECTED`: `{ reason: string }`, one of `too_large`, `css_rejected` or `invalid`.\n Open-ended: tolerate new values.\n- `CONDITION_NOT_SUPPORTED`: `{ field: string, path: string }`, the condition type that is not\n accepted and where it sits in the request. For a condition shape refused where it sits\n also `operator: string` and, when there is an equivalent operator for `requiredConditions`,\n `invertTo: string`.\n- `REFERENCE_NOT_FOUND`: `{ path: string, kind: string }`, where the unknown id sits in the\n request and what it refers to: `document`, `product`, `tier`, `cta`, `folder`, `broadcast` or\n `step`. Open-ended: tolerate new values.\n- `TAG_NOT_FOUND` (from a group rule): `{ tag: string }`, the tag name that does not exist.\n- `GROUP_REFERENCE_NOT_FOUND`: `{ groupIds: string[] }`, the group ids that are not in the account.\n- `GROUP_LIMIT_REACHED`: `{ limit: integer }`, the most groups an account can create through the API.\n","uniqueKey":"error.details","typeLabel":"object"}},"description":"The error. Every error response from the API has it: `code`, `message`, `retryable` and, for some codes, `retryAfterSeconds` and `details`.","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","retryable":true,"retryAfterSeconds":123,"details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"27ec1e3e-f736-499d-a031-ecf350f9528c":{"description":"`IDEMPOTENCY_KEY_CONFLICT` (not retryable: the same key was already used\nwith a different body; use a new key) or `IDEMPOTENCY_KEY_IN_PROGRESS`\n(retryable: a request with this key is still being processed;\n`retryAfterSeconds` suggests a backoff).\n","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","retryable"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code — switch on this, not `message`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable detail. May change wording without notice.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","description":"Whether retrying the identical request may succeed.","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"retryAfterSeconds":{"type":"integer","description":"Present only when a concrete backoff hint applies.","uniqueKey":"error.retryAfterSeconds","typeLabel":"integer"},"details":{"type":"object","description":"Present only for a few specific codes:\n- `PROTECTION_RULE_CONFLICT`: `{ rule: string }`, the protection rule that refused the request\n (`form`, `restricted_access`, `paid_lead_gate`, `free_lead_gate` or `form_no_access_controls`).\n Open-ended: tolerate new values.\n- `NEXT_POST_RULE_EXISTS`: `{ ruleId: string }`, the existing next-post rule.\n- `NOTION_FETCH_FAILED`: `{ notionErrorCode: string }`, one of\n `NOTION_ERROR_PRIVATE`, `NOTION_ERROR_NOT_FOUND`,\n `NOTION_ERROR_NETWORK`, `NOTION_ERROR_RATE_LIMIT`,\n `NOTION_ERROR_TEMPORARILY_UNAVAILABLE`,\n `NOTION_ERROR_PAGE_REJECTED`, `NOTION_ERROR_UNKNOWN`.\n- `HTML_REJECTED`: `{ reason: string }`, one of `too_large`, `css_rejected` or `invalid`.\n Open-ended: tolerate new values.\n- `CONDITION_NOT_SUPPORTED`: `{ field: string, path: string }`, the condition type that is not\n accepted and where it sits in the request. For a condition shape refused where it sits\n also `operator: string` and, when there is an equivalent operator for `requiredConditions`,\n `invertTo: string`.\n- `REFERENCE_NOT_FOUND`: `{ path: string, kind: string }`, where the unknown id sits in the\n request and what it refers to: `document`, `product`, `tier`, `cta`, `folder`, `broadcast` or\n `step`. Open-ended: tolerate new values.\n- `TAG_NOT_FOUND` (from a group rule): `{ tag: string }`, the tag name that does not exist.\n- `GROUP_REFERENCE_NOT_FOUND`: `{ groupIds: string[] }`, the group ids that are not in the account.\n- `GROUP_LIMIT_REACHED`: `{ limit: integer }`, the most groups an account can create through the API.\n","uniqueKey":"error.details","typeLabel":"object"}},"description":"The error. Every error response from the API has it: `code`, `message`, `retryable` and, for some codes, `retryAfterSeconds` and `details`.","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","retryable":true,"retryAfterSeconds":123,"details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"17bbe621-b9fd-4794-8630-c13f2c223d00":{"description":"The request is well-formed but the rule cannot be used. Nothing was\ncreated. None is retryable as is.\n`EMPTY_FILTER`: the rule has no condition in any of its three lists.\n`CONDITION_NOT_SUPPORTED`: a condition type the API does not accept yet\n(`custom_field`), or a condition shape that gives a wrong answer for some\ncontacts in the list it is in (see Group conditions);\n`details` is `{ field, path }`, plus `{ operator, invertTo }` for the second\nkind (`invertTo` is left out when there is no equivalent operator).\n`REFERENCE_NOT_FOUND`: a condition carries an id that is not in your\naccount (unknown, deleted, in the trash or someone else's, all\nindistinguishable); `details` is `{ path, kind }`, with `kind` one of\n`document`, `product`, `tier`, `cta`, `folder`, `broadcast` or `step`.\n`TAG_NOT_FOUND`: a `tag` condition names a tag your account does not\nhave (names are matched exactly, case included); `details` is\n`{ tag }`. Look names up with `GET /api/preview/tags`.\n`GROUP_REFERENCE_NOT_FOUND`: a `group_membership` condition refers to a\ngroup that is not in your account; `details` is `{ groupIds }`.\n`GROUP_LIMIT_REACHED`: the account is at the limit of 100 groups;\n`details` is `{ limit }`. Delete groups you no longer use in the\ndashboard, then retry with a new `Idempotency-Key`.\n","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","retryable"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code — switch on this, not `message`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable detail. May change wording without notice.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","description":"Whether retrying the identical request may succeed.","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"retryAfterSeconds":{"type":"integer","description":"Present only when a concrete backoff hint applies.","uniqueKey":"error.retryAfterSeconds","typeLabel":"integer"},"details":{"type":"object","description":"Present only for a few specific codes:\n- `PROTECTION_RULE_CONFLICT`: `{ rule: string }`, the protection rule that refused the request\n (`form`, `restricted_access`, `paid_lead_gate`, `free_lead_gate` or `form_no_access_controls`).\n Open-ended: tolerate new values.\n- `NEXT_POST_RULE_EXISTS`: `{ ruleId: string }`, the existing next-post rule.\n- `NOTION_FETCH_FAILED`: `{ notionErrorCode: string }`, one of\n `NOTION_ERROR_PRIVATE`, `NOTION_ERROR_NOT_FOUND`,\n `NOTION_ERROR_NETWORK`, `NOTION_ERROR_RATE_LIMIT`,\n `NOTION_ERROR_TEMPORARILY_UNAVAILABLE`,\n `NOTION_ERROR_PAGE_REJECTED`, `NOTION_ERROR_UNKNOWN`.\n- `HTML_REJECTED`: `{ reason: string }`, one of `too_large`, `css_rejected` or `invalid`.\n Open-ended: tolerate new values.\n- `CONDITION_NOT_SUPPORTED`: `{ field: string, path: string }`, the condition type that is not\n accepted and where it sits in the request. For a condition shape refused where it sits\n also `operator: string` and, when there is an equivalent operator for `requiredConditions`,\n `invertTo: string`.\n- `REFERENCE_NOT_FOUND`: `{ path: string, kind: string }`, where the unknown id sits in the\n request and what it refers to: `document`, `product`, `tier`, `cta`, `folder`, `broadcast` or\n `step`. Open-ended: tolerate new values.\n- `TAG_NOT_FOUND` (from a group rule): `{ tag: string }`, the tag name that does not exist.\n- `GROUP_REFERENCE_NOT_FOUND`: `{ groupIds: string[] }`, the group ids that are not in the account.\n- `GROUP_LIMIT_REACHED`: `{ limit: integer }`, the most groups an account can create through the API.\n","uniqueKey":"error.details","typeLabel":"object"}},"description":"The error. Every error response from the API has it: `code`, `message`, `retryable` and, for some codes, `retryAfterSeconds` and `details`.","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"emptyFilter":{"title":"emptyFilter","value":{"error":{"code":"EMPTY_FILTER","message":"The filter has no conditions. Add at least one condition, or the group would match every contact","retryable":false}}},"conditionNotSupported":{"title":"conditionNotSupported","value":{"error":{"code":"CONDITION_NOT_SUPPORTED","message":"The custom_field condition is not supported through the API yet. Remove it from the filter","retryable":false,"details":{"field":"custom_field","path":"filter.conditions.1"}}}},"referenceNotFound":{"title":"referenceNotFound","value":{"error":{"code":"REFERENCE_NOT_FOUND","message":"A condition refers to something that is not in your account","retryable":false,"details":{"path":"filter.conditions.0.documentId","kind":"document"}}}},"tagNotFound":{"title":"tagNotFound","value":{"error":{"code":"TAG_NOT_FOUND","message":"A tag condition names a tag that is not in your account","retryable":false,"details":{"tag":"newsletter"}}}},"groupReferenceNotFound":{"title":"groupReferenceNotFound","value":{"error":{"code":"GROUP_REFERENCE_NOT_FOUND","message":"A group condition refers to a group that is not in your account","retryable":false,"details":{"groupIds":["9c1e4a7b-2d3f-4e58-a6b0-5f8d7c3e1a24"]}}}},"groupLimitReached":{"title":"groupLimitReached","value":{"error":{"code":"GROUP_LIMIT_REACHED","message":"This account has reached its group limit","retryable":false,"details":{"limit":100}}}}},"exampleType":"examples"}},"exampleType":"examples"},"0b4a8741-63b8-4ee0-83c2-daf624e0f6f1":{"description":"Rate limited (`code: RATE_LIMITED`, always retryable): see the `Retry-After` header and `X-RateLimit-*` headers. Or too many requests running at once (`code: TOO_MANY_CONCURRENT_REQUESTS`, always retryable): `Retry-After` is `1` and there are no `X-RateLimit-*` headers.","headers":{"Retry-After":{"schema":{"type":"integer"}},"X-RateLimit-Limit":{"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"schema":{"type":"integer"}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Unix timestamp (seconds) when the limit resets."}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","retryable"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code — switch on this, not `message`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable detail. May change wording without notice.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","description":"Whether retrying the identical request may succeed.","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"retryAfterSeconds":{"type":"integer","description":"Present only when a concrete backoff hint applies.","uniqueKey":"error.retryAfterSeconds","typeLabel":"integer"},"details":{"type":"object","description":"Present only for a few specific codes:\n- `PROTECTION_RULE_CONFLICT`: `{ rule: string }`, the protection rule that refused the request\n (`form`, `restricted_access`, `paid_lead_gate`, `free_lead_gate` or `form_no_access_controls`).\n Open-ended: tolerate new values.\n- `NEXT_POST_RULE_EXISTS`: `{ ruleId: string }`, the existing next-post rule.\n- `NOTION_FETCH_FAILED`: `{ notionErrorCode: string }`, one of\n `NOTION_ERROR_PRIVATE`, `NOTION_ERROR_NOT_FOUND`,\n `NOTION_ERROR_NETWORK`, `NOTION_ERROR_RATE_LIMIT`,\n `NOTION_ERROR_TEMPORARILY_UNAVAILABLE`,\n `NOTION_ERROR_PAGE_REJECTED`, `NOTION_ERROR_UNKNOWN`.\n- `HTML_REJECTED`: `{ reason: string }`, one of `too_large`, `css_rejected` or `invalid`.\n Open-ended: tolerate new values.\n- `CONDITION_NOT_SUPPORTED`: `{ field: string, path: string }`, the condition type that is not\n accepted and where it sits in the request. For a condition shape refused where it sits\n also `operator: string` and, when there is an equivalent operator for `requiredConditions`,\n `invertTo: string`.\n- `REFERENCE_NOT_FOUND`: `{ path: string, kind: string }`, where the unknown id sits in the\n request and what it refers to: `document`, `product`, `tier`, `cta`, `folder`, `broadcast` or\n `step`. Open-ended: tolerate new values.\n- `TAG_NOT_FOUND` (from a group rule): `{ tag: string }`, the tag name that does not exist.\n- `GROUP_REFERENCE_NOT_FOUND`: `{ groupIds: string[] }`, the group ids that are not in the account.\n- `GROUP_LIMIT_REACHED`: `{ limit: integer }`, the most groups an account can create through the API.\n","uniqueKey":"error.details","typeLabel":"object"}},"description":"The error. Every error response from the API has it: `code`, `message`, `retryable` and, for some codes, `retryAfterSeconds` and `details`.","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","retryable":true,"retryAfterSeconds":123,"details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"baac1a39-675c-4601-a097-3802dd7d2316":{"description":"`INTERNAL_ERROR` (retryable). Something failed on our side; the cause is not echoed. Retry with the same `Idempotency-Key`.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","retryable"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code — switch on this, not `message`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable detail. May change wording without notice.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","description":"Whether retrying the identical request may succeed.","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"retryAfterSeconds":{"type":"integer","description":"Present only when a concrete backoff hint applies.","uniqueKey":"error.retryAfterSeconds","typeLabel":"integer"},"details":{"type":"object","description":"Present only for a few specific codes:\n- `PROTECTION_RULE_CONFLICT`: `{ rule: string }`, the protection rule that refused the request\n (`form`, `restricted_access`, `paid_lead_gate`, `free_lead_gate` or `form_no_access_controls`).\n Open-ended: tolerate new values.\n- `NEXT_POST_RULE_EXISTS`: `{ ruleId: string }`, the existing next-post rule.\n- `NOTION_FETCH_FAILED`: `{ notionErrorCode: string }`, one of\n `NOTION_ERROR_PRIVATE`, `NOTION_ERROR_NOT_FOUND`,\n `NOTION_ERROR_NETWORK`, `NOTION_ERROR_RATE_LIMIT`,\n `NOTION_ERROR_TEMPORARILY_UNAVAILABLE`,\n `NOTION_ERROR_PAGE_REJECTED`, `NOTION_ERROR_UNKNOWN`.\n- `HTML_REJECTED`: `{ reason: string }`, one of `too_large`, `css_rejected` or `invalid`.\n Open-ended: tolerate new values.\n- `CONDITION_NOT_SUPPORTED`: `{ field: string, path: string }`, the condition type that is not\n accepted and where it sits in the request. For a condition shape refused where it sits\n also `operator: string` and, when there is an equivalent operator for `requiredConditions`,\n `invertTo: string`.\n- `REFERENCE_NOT_FOUND`: `{ path: string, kind: string }`, where the unknown id sits in the\n request and what it refers to: `document`, `product`, `tier`, `cta`, `folder`, `broadcast` or\n `step`. Open-ended: tolerate new values.\n- `TAG_NOT_FOUND` (from a group rule): `{ tag: string }`, the tag name that does not exist.\n- `GROUP_REFERENCE_NOT_FOUND`: `{ groupIds: string[] }`, the group ids that are not in the account.\n- `GROUP_LIMIT_REACHED`: `{ limit: integer }`, the most groups an account can create through the API.\n","uniqueKey":"error.details","typeLabel":"object"}},"description":"The error. Every error response from the API has it: `code`, `message`, `retryable` and, for some codes, `retryAfterSeconds` and `details`.","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","retryable":true,"retryAfterSeconds":123,"details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"8e418044-381e-41f2-b410-c905f8419dbd":{"description":"A server-side dependency is temporarily down (`RATE_LIMIT_UNAVAILABLE`\nor `SERVICE_UNAVAILABLE`); not a problem with the request or key.\nAlways retryable; honor `retryAfterSeconds` when present.\n`SERVICE_UNAVAILABLE` is also returned when the service was too busy to\nstart the create: nothing was created, and retrying with the same\n`Idempotency-Key` is safe. The group endpoints also return it when a\nvery heavy rule could not be counted within about 10 seconds:\nsimplify the rule or retry.\n","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","retryable"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code — switch on this, not `message`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable detail. May change wording without notice.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","description":"Whether retrying the identical request may succeed.","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"retryAfterSeconds":{"type":"integer","description":"Present only when a concrete backoff hint applies.","uniqueKey":"error.retryAfterSeconds","typeLabel":"integer"},"details":{"type":"object","description":"Present only for a few specific codes:\n- `PROTECTION_RULE_CONFLICT`: `{ rule: string }`, the protection rule that refused the request\n (`form`, `restricted_access`, `paid_lead_gate`, `free_lead_gate` or `form_no_access_controls`).\n Open-ended: tolerate new values.\n- `NEXT_POST_RULE_EXISTS`: `{ ruleId: string }`, the existing next-post rule.\n- `NOTION_FETCH_FAILED`: `{ notionErrorCode: string }`, one of\n `NOTION_ERROR_PRIVATE`, `NOTION_ERROR_NOT_FOUND`,\n `NOTION_ERROR_NETWORK`, `NOTION_ERROR_RATE_LIMIT`,\n `NOTION_ERROR_TEMPORARILY_UNAVAILABLE`,\n `NOTION_ERROR_PAGE_REJECTED`, `NOTION_ERROR_UNKNOWN`.\n- `HTML_REJECTED`: `{ reason: string }`, one of `too_large`, `css_rejected` or `invalid`.\n Open-ended: tolerate new values.\n- `CONDITION_NOT_SUPPORTED`: `{ field: string, path: string }`, the condition type that is not\n accepted and where it sits in the request. For a condition shape refused where it sits\n also `operator: string` and, when there is an equivalent operator for `requiredConditions`,\n `invertTo: string`.\n- `REFERENCE_NOT_FOUND`: `{ path: string, kind: string }`, where the unknown id sits in the\n request and what it refers to: `document`, `product`, `tier`, `cta`, `folder`, `broadcast` or\n `step`. Open-ended: tolerate new values.\n- `TAG_NOT_FOUND` (from a group rule): `{ tag: string }`, the tag name that does not exist.\n- `GROUP_REFERENCE_NOT_FOUND`: `{ groupIds: string[] }`, the group ids that are not in the account.\n- `GROUP_LIMIT_REACHED`: `{ limit: integer }`, the most groups an account can create through the API.\n","uniqueKey":"error.details","typeLabel":"object"}},"description":"The error. Every error response from the API has it: `code`, `message`, `retryable` and, for some codes, `retryAfterSeconds` and `details`.","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","retryable":true,"retryAfterSeconds":123,"details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"6d0f2653-1aeb-4278-9084-017dd127ec0f":{"apiKey":{"type":"http","scheme":"bearer","bearerFormat":"dr_live_\u003ckeyId>_\u003csecret>","description":"A key generated from Settings → Developers, sent as\n`Authorization: Bearer dr_live_\u003c12 hex chars>_\u003c64 hex chars>`. Keys\ncarry explicit scopes — each endpoint states the one it requires.\nThe full key is shown exactly once at generation time and cannot be\nretrieved again; only the `keyId` prefix is shown afterward. A\nrevoked key fails auth on its very next request.\n","scopes":[],"schemeName":"apiKey"}}},"servers":{"7304e0b3-d967-42dc-a414-a807932689bf":{"url":"https://docurise.io","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"dr_live_\u003ckeyId>_\u003csecret>","description":"A key generated from Settings → Developers, sent as\n`Authorization: Bearer dr_live_\u003c12 hex chars>_\u003c64 hex chars>`. Keys\ncarry explicit scopes — each endpoint states the one it requires.\nThe full key is shown exactly once at generation time and cannot be\nretrieved again; only the `keyId` prefix is shown afterward. A\nrevoked key fails auth on its very next request.\n","scopes":[],"schemeName":"apiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"A key generated from Settings → Developers, sent as\n`Authorization: Bearer dr_live_\u003c12 hex chars>_\u003c64 hex chars>`. Keys\ncarry explicit scopes — each endpoint states the one it requires.\nThe full key is shown exactly once at generation time and cannot be\nretrieved again; only the `keyId` prefix is shown afterward. A\nrevoked key fails auth on its very next request.\n","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"apiKey","name":"Authorization"}],"title":"apiKey"}]},"originalFileLocation":"api-reference/openapi.yaml"},"subdomain":"docu-rise","siteName":"DocuRise Developer Docs","title":"Create a group - DocuRise Developer Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/create-segment","matchLevel":0},"ko":{"href":"/ko/api-reference/create-segment","matchLevel":1}}},"lastModified":"2026-10-26T16:11:34.234Z","originalFileLocation":"api-reference/create-segment.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create one group from a rule; an Idempotency-Key makes retries safe\">\u003cmeta data-mint-head name=\"application-name\" content=\"DocuRise Developer Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/docu-rise/PjNyTTc63ErGT2fG/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/docu-rise/PjNyTTc63ErGT2fG/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/docu-rise/PjNyTTc63ErGT2fG/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/docu-rise/PjNyTTc63ErGT2fG/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/docu-rise/PjNyTTc63ErGT2fG/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/docu-rise/PjNyTTc63ErGT2fG/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/docu-rise/PjNyTTc63ErGT2fG/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/docu-rise/PjNyTTc63ErGT2fG/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/docu-rise/PjNyTTc63ErGT2fG/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a group - DocuRise Developer Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create one group from a rule; an Idempotency-Key makes retries safe\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"DocuRise Developer Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docurise.io/docs/api-reference/create-segment\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://docu-rise.mintlify.app/_mintlify/api/og/v2?division=Audiences\u0026amp;title=Create+a+group\u0026amp;description=Create+one+group+from+a+rule%3B+an+Idempotency-Key+makes+retries+safe\u0026amp;theme=53f5ca0b0069a8a509ebc847\u0026amp;signature=2d1f6a5857c4bed6d403b57d05f25237d897f71833deb10313f6593e82e0b67d\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create a group - DocuRise Developer Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create one group from a rule; an Idempotency-Key makes retries safe\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://docu-rise.mintlify.app/_mintlify/api/og/v2?division=Audiences\u0026amp;title=Create+a+group\u0026amp;description=Create+one+group+from+a+rule%3B+an+Idempotency-Key+makes+retries+safe\u0026amp;theme=53f5ca0b0069a8a509ebc847\u0026amp;signature=2d1f6a5857c4bed6d403b57d05f25237d897f71833deb10313f6593e82e0b67d\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/docu-rise/PjNyTTc63ErGT2fG/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"DocuRise Developer Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#DA350B\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docurise.io/docs/api-reference/create-segment\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/create-segment.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docurise.io/docs/api-reference/create-segment\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docurise.io/docs/ko/api-reference/create-segment\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docurise.io/docs/api-reference/create-segment\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docurise.io/#organization\",\"name\":\"DocuRise Developer Docs\",\"url\":\"https://docurise.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/docu-rise/ClhhLqgPXOXvt7Zz/logo.png?fit=max\u0026auto=format\u0026n=ClhhLqgPXOXvt7Zz\u0026q=85\u0026s=b73379a7630a12945d164a128a6ddb12\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docurise.io/docs#website\",\"name\":\"DocuRise Developer Docs\",\"url\":\"https://docurise.io/docs\",\"publisher\":{\"@id\":\"https://docurise.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docurise.io/docs/api-reference/create-segment#webpage\",\"url\":\"https://docurise.io/docs/api-reference/create-segment\",\"name\":\"Create a group\",\"description\":\"Create one group from a rule; an Idempotency-Key makes retries safe\",\"dateModified\":\"2026-10-26T16:11:34.234Z\",\"isPartOf\":{\"@id\":\"https://docurise.io/docs#website\"},\"breadcrumb\":{\"@id\":\"https://docurise.io/docs/api-reference/create-segment#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docurise.io/docs/api-reference/create-segment#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Audiences\",\"item\":\"https://docurise.io/docs/api-reference/list-tags\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a group\",\"item\":\"https://docurise.io/docs/api-reference/create-segment\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docurise.io/docs/api-reference/create-segment#apireference\",\"headline\":\"Create a group\",\"name\":\"Create a group\",\"description\":\"Create one group from a rule; an Idempotency-Key makes retries safe\",\"url\":\"https://docurise.io/docs/api-reference/create-segment\",\"mainEntityOfPage\":{\"@id\":\"https://docurise.io/docs/api-reference/create-segment#webpage\"},\"dateModified\":\"2026-10-26T16:11:34.234Z\",\"publisher\":{\"@id\":\"https://docurise.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docurise.io/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"DocuRise Developer Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"DocuRise Developer Docs","nav":{"global":null,"languages":[{"language":"en","tabs":[{"tab":"Guides","icon":"book-open","pages":[{"title":"Guides","href":""}]},{"tab":"API Reference","icon":"code","groups":[{"group":"Documents","pages":[{"title":"Create a document","openapi":"api-reference/openapi.yaml POST /api/preview/documents","href":"/api-reference/create-document"},{"title":"List documents","openapi":"api-reference/openapi.yaml GET /api/preview/documents","href":"/api-reference/list-documents"},{"title":"Get a document","openapi":"api-reference/openapi.yaml GET /api/preview/documents/{id}","href":"/api-reference/get-document"},{"title":"Update a document","openapi":"api-reference/openapi.yaml PATCH /api/preview/documents/{id}","href":"/api-reference/update-document"},{"title":"Get document analytics","openapi":"api-reference/openapi.yaml GET /api/preview/documents/{id}/analytics","href":"/api-reference/get-document-analytics"},{"title":"Get document analytics by channel","openapi":"api-reference/openapi.yaml GET /api/preview/documents/{id}/analytics/channels","href":"/api-reference/get-document-analytics-channels"},{"title":"Get form funnel","openapi":"api-reference/openapi.yaml GET /api/preview/documents/{id}/analytics/funnel","href":"/api-reference/get-form-funnel"},{"title":"List top documents","openapi":"api-reference/openapi.yaml GET /api/preview/analytics/documents","href":"/api-reference/list-top-documents"}]},{"group":"Folders","pages":[{"title":"List folders and courses","openapi":"api-reference/openapi.yaml GET /api/preview/folders","href":"/api-reference/list-folders"}]},{"group":"Products","pages":[{"title":"List products","openapi":"api-reference/openapi.yaml GET /api/preview/products","href":"/api-reference/list-products"}]},{"group":"Audiences","pages":[{"title":"List tags","openapi":"api-reference/openapi.yaml GET /api/preview/tags","href":"/api-reference/list-tags"},{"title":"Create a tag","openapi":"api-reference/openapi.yaml POST /api/preview/tags","href":"/api-reference/create-tag"},{"title":"List groups","description":"List your contact groups with their member counts (counts only, no member data)","openapi":"api-reference/openapi.yaml GET /api/preview/segments","href":"/api-reference/list-segments"},{"title":"Create a group","openapi":"api-reference/openapi.yaml POST /api/preview/segments","href":"/api-reference/create-segment"},{"title":"Preview a group rule","description":"Count who a rule would match without saving anything","openapi":"api-reference/openapi.yaml POST /api/preview/segments/preview","href":"/api-reference/preview-segment"},{"title":"Get a group","openapi":"api-reference/openapi.yaml GET /api/preview/segments/{id}","href":"/api-reference/get-segment"},{"title":"Group conditions","href":"/api-reference/group-conditions"}]},{"group":"Contacts","pages":[{"title":"Add a tag to a contact","openapi":"api-reference/openapi.yaml PUT /api/preview/contacts/{contactId}/tags/{tagName}","href":"/api-reference/add-contact-tag"},{"title":"Remove a tag from a contact","openapi":"api-reference/openapi.yaml DELETE /api/preview/contacts/{contactId}/tags/{tagName}","href":"/api-reference/remove-contact-tag"}]},{"group":"Email","pages":[{"title":"List email broadcasts","openapi":"api-reference/openapi.yaml GET /api/preview/email/broadcasts","href":"/api-reference/list-email-broadcasts"},{"title":"Get broadcast insights","openapi":"api-reference/openapi.yaml GET /api/preview/email/broadcasts/{id}/insights","href":"/api-reference/get-broadcast-insights"},{"title":"List automations","openapi":"api-reference/openapi.yaml GET /api/preview/automations","href":"/api-reference/list-automations"}]},{"group":"Instagram","pages":[{"title":"Create an Instagram rule","openapi":"api-reference/openapi.yaml POST /api/preview/instagram/rules","href":"/api-reference/create-instagram-rule"},{"title":"List Instagram rules","openapi":"api-reference/openapi.yaml GET /api/preview/instagram/rules","href":"/api-reference/list-instagram-rules"},{"title":"Get an Instagram rule","openapi":"api-reference/openapi.yaml GET /api/preview/instagram/rules/{id}","href":"/api-reference/get-instagram-rule"},{"title":"Update an Instagram rule","openapi":"api-reference/openapi.yaml PATCH /api/preview/instagram/rules/{id}","href":"/api-reference/update-instagram-rule"}]},{"group":"Account","pages":[{"title":"Inspect the calling key","openapi":"api-reference/openapi.yaml GET /api/preview/whoami","href":"/api-reference/whoami"}]}]}]},{"language":"ko","pages":[{"title":"ko","href":"/ko/api-reference/create-segment"}]}]},"title":"Create a group - DocuRise Developer Docs","buildId":"dpl_3DJU2xKhT5gDPFQL5Tqv7AFnkWsF","deploymentId":"dpl_3DJU2xKhT5gDPFQL5Tqv7AFnkWsF","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DsGgv5pK.js","utils-B0h6ZXi-.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-IgrnFwPw.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C49-TBER.js","snippetPresets-BPHn-9OB.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CGBwAHwX.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BjABHCCH.js","shallow-C0Uj5sOI.js","getApiPlaygroundDisplay-BnYiIeY4.js","CodeSnippet-BJWWrlBw.js","CodeSnippets-bxE5aDye.js","Page-BBU7roUf.js","getPastedJson-BAjriezQ.js","icon-BqcS52QC.js","MethodPill-BPGyN9me.js","DuplicateIcon-CCf2giLL.js","createIcon-CVH8aNt2.js","DynamicMarkdown-BklwmxA6.js","SectionHeading-DYCZQFxh.js","axios-vUo_bRtp.js","Markdown-D26rHnOC.js","clsx-DkiOUx4h.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DI8jfVGc.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DwJy-csb.js"]}