---
title: "How do I create a policy collection?"
slug: "how-do-i-create-a-policy-collection"
tags: ["policy collection", "group"]
updated: 2024-10-17T16:09:44Z
published: 2024-10-17T16:09:44Z
canonical: "support.lusid.com/how-do-i-create-a-policy-collection"
---

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

# How do I create a policy collection?

Providing you are a LUSID user with sufficient privileges, you can create a policy collection to group logically similar [policies](/v1/docs/what-are-a-policy-and-a-policy-collection) together.

> [!NOTE]
> Note
> 
> If you are the LUSID domain owner, you are automatically assigned the built-in lusid-administrator role, which has all the permissions necessary to perform the operations in this article.

For example, you might create a policy collection to group a [feature policy](/v1/docs/how-do-i-create-a-feature-policy) with a particular [data policy](/v1/docs/how-do-i-create-a-data-policy) that together permit operations on a specific dataset. Once created, you should assign the policy collection to a [role](/v1/docs/what-is-a-role).

## Using the LUSID web app

1. Sign in to the [LUSID web app](https://www.lusid.com/app) using the credentials of a LUSID administrator.
2. From the left-hand menu, select **Identity and Access > Policy Collections**: ![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image(264).png?sv=2026-02-06&spr=https&st=2026-11-04T02%3A14%3A46Z&se=2026-11-04T03%3A14%3A46Z&sr=c&sp=r&sig=uk1FHX69zj958mMLO4l8A89I%2BzqaXM2rygNsww7%2BEd8%3D)
3. On the **Policy collections** dashboard, click the **Create policy collection** button.
4. Specify a unique **Code** for the policy collection, and then assign suitable policies using the **Policies > Choose** dropdown. Optionally, you can choose to nest policy collections using the **Policy collections > Choose** dropdown: ![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image(265).png?sv=2026-02-06&spr=https&st=2026-11-04T02%3A14%3A46Z&se=2026-11-04T03%3A14%3A46Z&sr=c&sp=r&sig=uk1FHX69zj958mMLO4l8A89I%2BzqaXM2rygNsww7%2BEd8%3D)

## Using the Access API

1. [Obtain an API access token](/v1/docs/how-do-i-obtain-and-use-a-short-lived-api-access-token-from-okta).
2. Call the [CreatePolicyCollection](https://www.lusid.com/docs/api/access/endpoints/policies/CreatePolicyCollection) API, passing in your API access token and assigning policies (or nested policy collections). For example:

```sql
curl -X POST "https://<your-domain>.lusid.com/access/api/policycollections"
   -H "Authorization: Bearer <your-API-access-token>"
   -H "Content-Type: application/json"
   -d '{"code":"allow-portfolio-access","policies":[{"scope":"default","code":"data-read-portfolios-quotes-us"},{"scope":"default","code":"feature-read-portfolios-quotes-us"}],"policyCollections":[]}}'
```

The response contains the scope and code that together uniquely identify the policy collection:

```json
{
    "id": {
        "scope": "default",
        "code": "allow-portfolio-access"
    },
    "policies": [
        {
            "scope": "default",
            "code": "data-read-portfolios-quotes-us"
        },
        {
            "scope": "default",
            "code": "feature-read-portfolios-quotes-us"
        }
    ],
    "policyCollections": [],
    ...
}
```